XInputGetCapabilities-Funktion (xinput.h)

Artikel
10/28/2023

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

Weitere Informationen

XInput-Funktionen

XInputGetState

XInputSetState

Freigeben über