Pular para o conteúdo principal
Obtém o número de chaves de controle genérico, como chaves hat e direcionais (D-pads), no dispositivo.

Sintaxe

Parâmetros

Este método não tem parâmetros.

Valor retornado

Tipo: uint32_t O número de chaves de controle no dispositivo ou 0 se o dispositivo não tiver chaves de controle.

Comentários

As chaves de controle são as chaves brutas, não mapeadas e de várias posições de um dispositivo, como chaves hat e direcionais (D-pads). Um dispositivo tem chaves de controle quando o valor retornado por GetSupportedInput inclui GameInputKindControllerSwitch. As leituras do dispositivo que incluem GameInputKindControllerSwitch relatam o mesmo número de chaves por meio de IGameInputReading::GetControllerSwitchCount. Use o valor retornado para dimensionar a matriz que você passa para GetControllerSwitchInfo ou para IGameInputReading::GetControllerSwitchState. O número de chaves não muda enquanto o dispositivo está conectado. No GameInput v3 e anteriores, essas informações estavam disponíveis no membro controllerSwitchCount da estrutura GameInputControllerInfo, referenciada pelo membro controllerInfo da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.

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
GetControllerSwitchInfo
IGameInputReading::GetControllerSwitchCount
IGameInputReading::GetControllerSwitchState
IGameInputDevice

Histórico de versões

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