Funzione XInputGetState (xinput.h)

Articolo
03/05/2024

Recupera lo stato corrente del controller specificato.

Sintassi

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

Parametri

[in] dwUserIndex

Indice del controller dell'utente. Può essere un valore compreso tra 0 e 3. Per informazioni su come viene determinato questo valore e sul modo in cui il valore esegue il mapping agli indicatori nel controller, vedere Più controller.

[out] pState

Puntatore a una struttura XINPUT_STATE che riceve lo stato corrente del controller.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se il controller non è connesso, il valore restituito viene ERROR_DEVICE_NOT_CONNECTED.

Se la funzione ha esito negativo, il valore restituito è un codice di errore definito in Winerror.h. La funzione non usa SetLastError per impostare l'ultimo codice di errore del thread chiamante.

Commenti

Quando XInputGetState viene usato per recuperare i dati del controller, i trigger sinistro e destro vengono segnalati separatamente. Per motivi legacy, quando DirectInput recupera i dati del controller, i due trigger condividono lo stesso asse. Il comportamento legacy è evidente nella Pannello di controllo del dispositivo di gioco corrente, che usa DirectInput per lo stato del controller.

Requisiti della piattaforma

Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	xinput.h
Libreria	Xinput.lib; Xinput9_1_0.lib
DLL	Xinput1_4.dll; Xinput9_1_0.dll; Xinputuap.dll

Vedi anche