Função XInputGetState (xinput.h)

Artigo
08/28/2023

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.