Skip to main content

XInputGetStateWithToken

Recupera o estado atual do controle especificado e o associa a um token de pipeline de quadros D3DX.

Sintaxe

Parâmetros

dwUserIndex   _In_
Tipo: DWORD
Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. framePipelineToken   _In_
Tipo: UINT64
Token de pipeline de quadros D3DX. 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 é semelhante a XInputGetState, mas associa uma leitura de entrada específica a um quadro gráfico para análise posterior.
A partir da versão May Preview, o comportamento de XInputGetStateWithToken é idêntico ao de XInputGetState, pois o código subjacente do GameInput não está totalmente implementado.
Ao fornecer o token de pipeline de quadros, você pode posteriormente correlacionar as chamadas de API de entrada com quadros gráficos específicos no software PIX.

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