joyGetDevCaps-Funktion (joystickapi.h)

  • Artikel

Die joyGetDevCaps-Funktion fragt einen Joystick ab, um seine Funktionen zu bestimmen.

Syntax

MMRESULT joyGetDevCaps(
  UINT      uJoyID,
  LPJOYCAPS pjc,
  UINT      cbjc
);

Parameter

uJoyID

Bezeichner des abzufragten Joysticks. Gültige Werte für uJoyID liegen zwischen -1 und 15. Der Wert -1 ermöglicht den Abruf des szRegKey-Elements der JOYCAPS-Struktur , unabhängig davon, ob ein Gerät vorhanden ist oder nicht.

pjc

Zeiger auf eine JOYCAPS-Struktur , um die Funktionen des Joysticks zu enthalten.

cbjc

Größe der JOYCAPS-Struktur in Byte.

Rückgabewert

Gibt bei erfolgreicher Ausführung JOYERR_NOERROR oder einen der folgenden Fehlerwerte zurück:

Rückgabecode Beschreibung
MMSYSERR_NODRIVER
 Der Joysticktreiber ist nicht vorhanden, oder der angegebene Joystickbezeichner ist ungültig. Der angegebene Joystickbezeichner ist ungültig.
MMSYSERR_INVALPARAM
 Es wurde ein ungültiger Parameter übergeben.

Hinweise

Verwenden Sie die joyGetNumDevs-Funktion , um die Anzahl der joystick-Geräte zu ermitteln, die vom Treiber unterstützt werden.

Diese Methode schlägt fehl, wenn ein ungültiger Wert für den cbjc-Parameter übergeben wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile joystickapi.h (windows.h einschließen)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Joysticks

Multimedia-Joystick-Funktionen