joyGetDevCapsA-Funktion (joystickapi.h)
Die joyGetDevCaps-Funktion fragt einen Joystick ab, um seine Funktionen zu bestimmen.
Syntax
MMRESULT joyGetDevCapsA(
UINT_PTR uJoyID,
LPJOYCAPSA 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 |
---|---|
|
Der Joysticktreiber ist nicht vorhanden, oder der angegebene Joystickbezeichner ist ungültig. Der angegebene Joystickbezeichner ist ungültig. |
|
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.
Hinweis
Der Joystickapi.h-Header definiert joyGetDevCaps als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für