Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
Hinweis Die Legacyversion XINPUT 9.1.0 (in Windows Vista und höher enthalten) hat unabhängig vom angeschlossenen Gerät immer einen festen Satz von Funktionen zurückgegeben.
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 |