Funzione XInputGetState (xinput.h)
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 |