Função XInputGetState (xinput.h)
Recupera o estado atual do controlador especificado.
Sintaxe
DWORD XInputGetState(
[in] DWORD dwUserIndex,
[out] XINPUT_STATE *pState
);
Parâmetros
[in] dwUserIndex
Índice do controlador do usuário. Pode ser um valor de 0 a 3. Para obter informações sobre como esse valor é determinado e como o valor é mapeado para indicadores no controlador, consulte Vários controladores.
[out] pState
Ponteiro para uma estrutura XINPUT_STATE que recebe o estado atual do controlador.
Retornar valor
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se o controlador não estiver conectado, o valor retornado será ERROR_DEVICE_NOT_CONNECTED.
Se a função falhar, o valor retornado será um código de erro definido em Winerror.h. A função não usa SetLastError para definir o código de último erro do thread de chamada.
Comentários
Quando XInputGetState é usado para recuperar dados do controlador, os gatilhos esquerdo e direito são relatados separadamente. Por motivos herdados, quando DirectInput recupera dados do controlador, os dois gatilhos compartilham o mesmo eixo. O comportamento herdado é perceptível na Painel de Controle de Dispositivo de Jogo atual, que usa DirectInput para o estado do controlador.
Requisitos da plataforma
Windows 8 (XInput 1.4), SDK do DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | xinput.h |
Biblioteca | Xinput.lib; Xinput9_1_0.lib |
DLL | Xinput1_4.dll; Xinput9_1_0.dll; Xinputuap.dll |