joyGetDevCapsW-Funktion (joystickapi.h)

  • Artikel

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

Syntax

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW 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-Members der JOYCAPS-Struktur , unabhängig davon, ob ein Gerät vorhanden ist oder nicht.

pjc

Zeiger auf eine JOYCAPS-Struktur , die die Funktionen des Joysticks enthält.

cbjc

Größe der JOYCAPS-Struktur in Bytes.

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 wurde.

Hinweis

Der joystickapi.h-Header definiert joyGetDevCaps als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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 (einschließlich Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Joysticks

Multimedia-Joystickfunktionen