XInputGetCapabilities-Funktion (xinput.h)
Ruft die Funktionen und Features eines verbundenen Controllers ab.
Syntax
DWORD XInputGetCapabilities(
[in] DWORD dwUserIndex,
[in] DWORD dwFlags,
[out] XINPUT_CAPABILITIES *pCapabilities
);
Parameter
[in] dwUserIndex
Index des Controllers des Benutzers. Kann ein Wert im Bereich von 0 bis 3 sein. Informationen dazu, wie dieser Wert bestimmt wird und wie der Wert Indikatoren auf dem Controller zugeordnet wird, finden Sie unter Mehrere Controller.
[in] dwFlags
Eingabeflags, die den Controllertyp identifizieren. Wenn dieser Wert 0 ist, werden die Funktionen aller Controller zurückgegeben, die mit dem System verbunden sind. Derzeit wird nur ein Wert unterstützt:
| Wert | BESCHREIBUNG |
|---|---|
| XINPUT_FLAG_GAMEPAD | Beschränken Sie die Abfrage auf Geräte des Controllertyps. |
Jeder andere Wert von dwflags als dem oben genannten oder 0 ist unzulässig und führt beim Debuggen zu einem Fehlerbruch.
[out] pCapabilities
Zeiger auf eine XINPUT_CAPABILITIES-Struktur , die die Controllerfunktionen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn der Controller nicht verbunden ist, wird der Rückgabewert ERROR_DEVICE_NOT_CONNECTED.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in WinError.h definierter Fehlercode. Die Funktion verwendet setLastError nicht, um den Code des letzten Fehlers des aufrufenden Threads festzulegen.
Hinweise
Plattformanforderungen
Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)Anforderungen
| Zielplattform | Windows |
| Kopfzeile | xinput.h |
| Bibliothek | Xinput.lib; Xinput9_1_0.lib |
| DLL | Xinput1_4.dll; Xinput9_1_0.dll |