joyGetDevCapsW-Funktion (joystickapi.h)
Die joyGetDevCaps-Funktion fragt einen Joystick ab, um seine Funktionen zu bestimmen.
Syntax
MMRESULT joyGetDevCapsW(
UINT_PTR uJoyID,
LPJOYCAPSW pjc,
UINT cbjc
);
Parameter
uJoyID
Bezeichner des Joysticks, der abgefragt werden soll. Gültige Werte für uJoyID- bereich von -1 bis 15. Ein Wert von -1 ermöglicht das Abrufen des szRegKey Mitglieds der JOYCAPS Struktur, ob ein Gerät vorhanden ist oder nicht.
pjc
Zeigen Sie auf eine JOYCAPS Struktur, um die Funktionen des Joysticks zu enthalten.
cbjc
Größe der JOYCAPS Struktur in Byte.
Rückgabewert
Gibt JOYERR_NOERROR zurück, wenn erfolgreich oder einer der folgenden Fehlerwerte ist:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Joysticktreiber ist nicht vorhanden, oder der angegebene Joystickbezeichner ist ungültig. Der angegebene Joystickbezeichner ist ungültig. |
|
Ein ungültiger Parameter wurde übergeben. |
Bemerkungen
Verwenden Sie die joyGetNumDevs Funktion, um die Anzahl der vom Treiber unterstützten Joystickgeräte zu ermitteln.
Diese Methode schlägt fehl, wenn ein ungültiger Wert für den cbjc--Parameter übergeben wird.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | joystickapi.h (enthalten Windows.h) |
| Library | Winmm.lib |
| DLL- | Winmm.dll |