Skip to main content

XInputGetState

Recupera o estado atual do controle especificado.

Sintaxe

Parâmetros

dwUserIndex   _In_
Tipo: DWORD
Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. pState   _Out_
Tipo: XINPUT_STATE*
Ponteiro para um objeto XINPUT_STATE que recebe o estado atual do controle.

Valor retornado

Tipo: DWORD Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Se o controle não estiver conectado, a função retornará ERROR_DEVICE_NOT_CONNECTED. Se a função falhar, ela retornará um código de erro definido em WinError.h.

Comentários

Essa função relata os gatilhos esquerdo e direito separadamente. No DirectInput, os dois gatilhos compartilhavam o mesmo eixo. A função XInputGetStateWithToken é semelhante, mas permite que o chamador forneça um token de pipeline de quadros D3DX para associar uma leitura de entrada específica a um quadro gráfico para análise posterior no PIX. Para obter mais informações, consulte O wrapper XInputOnGameInput.

Requisitos

Cabeçalho: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

Portabilidade do XInput para o GameInput
XInputOnGameInput
Last modified on October 6, 2026