JoyGetDevCaps

Aus API-Wiki
Wechseln zu: Navigation, Suche


Diese Funktion fragt die Eigenschaften eines angeschlossenen Joysticks ab und gibt diese zurück.

Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _ ByVal id As Long, _ lpCaps As JOYCAPS, _ ByVal uSize As Long) As Long


Parameter:

id [Übergabe]

Eine Nummer, die den abzufragenden Joystick bestimmt. Die folgenden Werte sind möglich:
Const JOYSTICKID1 = 0

Const JOYSTICKID2 = 1


lpCaps [Übergabe]

Ein Zeiger auf eine JOYCAPS-Struktur, die die ermittelten Werte erhält


uSize [Übergabe]

Die Länge der übergebenen JOYCAPS-Struktur in Byte.


Rückgabewert(e):

Die joyGetDevCaps-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn der Aufruf erfolgreich war. Mögliche andere Rückgabewerte sind:

Const MMSYSERR_BASE = 0 Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6) Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)


Sonstige Hinweise:

Unter Windows 9x/ME ist es nicht zwingend notwendig, dass uSize den korrekten Wert für die Länge der JOYCAPS-Struktur enthält, unter Windows NT/2000/XP/Vista ist es notwendig, da die Funktion ansonsten versagt.


Beispiel:

Dim JC As JOYCAPS

ret = joyGetDevCaps(JOYSTICKID1, JC, Len(JC))

If ret <> JOYERR_NOERROR Then

  ' Fehler beim Aufruf

End If


Verweise:

MSDN Library - joyGetDevCaps