Funzione XInputGetKeystroke (xinput.h)

Recupera un evento di input del gamepad.

Sintassi

DWORD XInputGetKeystroke(
  DWORD             dwUserIndex,
  DWORD             dwReserved,
  PXINPUT_KEYSTROKE pKeystroke
);

Parametri

dwUserIndex

[in] Indice del gamer connesso associato al dispositivo. Può essere un valore nell'intervallo 0-XUSER_MAX_COUNT - 1 o XUSER_INDEX_ANY per recuperare l'evento di input disponibile successivo da qualsiasi utente.

dwReserved

[in] Riservato

pKeystroke

[out] Puntatore a una struttura XINPUT_KEYSTROKE che riceve un evento di input.

Valore restituito

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

Se non sono stati premuti nuovi tasti, il valore restituito è ERROR_EMPTY.

Se il controller non è connesso o l'utente non lo ha attivato, il valore restituito è ERROR_DEVICE_NOT_CONNECTED. Vedere la sezione Osservazioni di seguito.

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

Commenti

I controller wireless non vengono considerati attivi all'avvio del sistema e le chiamate a una qualsiasi delle funzioni XInput prima che un controller wireless venga restituito attivo ERROR_DEVICE_NOT_CONNECTED. I titoli del gioco devono esaminare il codice restituito e essere preparati per gestire questa condizione. I controller cablati vengono attivati automaticamente quando vengono inseriti. I controller wireless vengono attivati quando l'utente attiva il controller.

Requisiti della piattaforma

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

Requisiti

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

Vedi anche

XINPUT_KEYSTROKE

Funzioni XInput