XInputGetState-Funktion (xinput.h)

Artikel
03/13/2024

Ruft den aktuellen Zustand des angegebenen Controllers ab.

Syntax

DWORD XInputGetState(
  [in]  DWORD        dwUserIndex,
  [out] XINPUT_STATE *pState
);

Parameter

[in] dwUserIndex

Index des Controller des Benutzers. Kann ein Wert 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.

[out] pState

Zeiger auf eine XINPUT_STATE-Struktur , die den aktuellen Status des Controllers 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 Letzten Fehlercode des aufrufenden Threads festzulegen.

Hinweise

Wenn XInputGetState zum Abrufen von Controllerdaten verwendet wird, werden die linken und rechten Trigger jeweils separat gemeldet. Aus Legacygründen teilen sich die beiden Trigger dieselbe Achse, wenn DirectInput Controllerdaten abruft. Das Legacyverhalten ist in der aktuellen Game Device-Systemsteuerung erkennbar, die DirectInput für den Controllerstatus verwendet.