Compartilhar via


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

Confira também

XINPUT_GAMEPAD

XINPUT_STATE

Funções XInput

XInputSetState