Pular para o conteúdo principal
Obtém o índice de usuário XInput atribuído ao dispositivo de entrada, se houver.

Sintaxe

Parâmetros

index   _Out_
Tipo: uint32_t*
Recebe o índice de usuário XInput baseado em zero (de 0 a 3) do dispositivo. Se o dispositivo não tiver um índice de usuário XInput, ele será definido como 0.

Valor retornado

Tipo: bool true se o dispositivo tiver atualmente um índice de usuário XInput; caso contrário, false.

Comentários

O índice de usuário XInput é o slot de controle que a API XInput usa para identificar um controle, o que normalmente corresponde ao indicador de jogador exibido no controle. Use este método para correlacionar um dispositivo GameInput com o controle ao qual o mesmo índice de usuário se refere no XInput, por exemplo, ao migrar um título do XInput para o GameInput um controle por vez. Somente os dispositivos expostos por meio do XInput têm um índice de usuário. Outros dispositivos, como teclados, mouses e a maioria dos controles de jogo HID, retornam false. Dispositivos agregados nunca têm um índice de usuário XInput. Quando um dispositivo é desconectado, o índice de usuário dele é liberado e o método retorna false. Ao contrário da maioria das propriedades de dispositivo, o índice de usuário XInput pode mudar enquanto o dispositivo está conectado. Quando ele muda, o GameInput notifica os retornos de chamada de dispositivo registrados com o valor GameInputDeviceEventXInputIndexUpdated de GameInputDeviceEvent. Chame GetXInputDeviceIndex novamente a partir do retorno de chamada para obter o novo índice.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
IGameInputDevice
GameInputDeviceEvent
IGameInput::RegisterDeviceCallback

Histórico de versões

Última modificação em 6 de novembro de 2026