JoyGetDevCaps

Aus API-Wiki
Version vom 13. April 2008, 13:43 Uhr von Henrik Ilgen (Diskussion | Beiträge) (Seite wurde an die Format-Vorlage angepasst, Hinweise ergänzt)

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.

Unter Windows 9x/ME wird MMSYSERR_INVALIDPARAM zurückgegeben, wenn der Parameter id ungültig ist. Unter Windows NT/2000/XP wird in diesem Falle MMSYSERR_NODRIVER zurückgegeben.


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


Quellen

MSDN Library - joyGetDevCaps