Pular para o conteúdo principal
Obtém o número de botões de controle genérico no dispositivo.

Sintaxe

Parâmetros

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

Valor retornado

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

Comentários

Os botões de controle são os botões brutos e não mapeados de um dispositivo. Um dispositivo tem botões de controle quando o valor retornado por GetSupportedInput inclui GameInputKindControllerButton. As leituras do dispositivo que incluem GameInputKindControllerButton relatam o mesmo número de botões por meio de IGameInputReading::GetControllerButtonCount. Use o valor retornado para dimensionar a matriz que você passa para GetControllerButtonLabels ou para IGameInputReading::GetControllerButtonState. O número de botões não muda enquanto o dispositivo está conectado. No GameInput v3 e anteriores, essas informações estavam disponíveis no membro controllerButtonCount 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
GetControllerButtonLabels
IGameInputReading::GetControllerButtonCount
IGameInputReading::GetControllerButtonState
IGameInputDevice

Histórico de versões

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