Skip to main content

​
XInputGetCapabilities

Recupera as funcionalidades e os recursos de um controle conectado.

​
Sintaxe

​
Parâmetros

dwUserIndex   _In_
Tipo: DWORD Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. dwFlags   _In_
Tipo: DWORD Sinalizadores de entrada que identificam o tipo de controle. Se esse valor for 0, serão retornadas as funcionalidades de todos os controles conectados ao sistema. No momento, só há suporte para XINPUT_FLAG_GAMEPAD. pCapabilities   _Out_
Tipo: XINPUT_CAPABILITIES* Ponteiro para um objeto XINPUT_CAPABILITIES que recebe as funcionalidades do controle.

​
Valor retornado

Tipo: DWORD Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Se o controle 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 do último erro do thread de chamada.

​
Comentários

A versão herdada XINPUT 9.1.0 (incluída no Windows Vista e posterior) sempre retornava um conjunto fixo de funcionalidades, independentemente do dispositivo conectado.
Para obter detalhes sobre as funcionalidades relatadas, consulte XINPUT_CAPABILITIES. 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