Pular para o conteúdo principal

GetExtraButtonIndexes

Obtém os índices de botão do controle dos botões extras no dispositivo para um determinado tipo de entrada.

Sintaxe

Parâmetros

inputKind   _In_
Tipo: GameInputKind
O tipo de entrada cujos índices de botões extras estão sendo solicitados. extraButtonCount   _In_
Tipo: uint32_t
Contagem esperada de índices de botão para botões extras. Esse número pode ser recuperado chamando GetExtraButtonCount. extraButtonIndexes   _Out_writes_(extraButtonCount)_
Tipo: uint8_t*
Ponteiro para a matriz de índices de botão.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Botões extras são botões do controle que existem no dispositivo físico, mas não fazem parte do mapeamento padrão para o tipo de entrada especificado. Antes de chamar este método, você deve primeiro chamar GetExtraButtonCount para determinar quantos botões extras estão disponíveis e passar essa contagem como o parâmetro extraButtonCount. O trecho de código a seguir demonstra como usar os botões extras de um gamepad:

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

GameInputKind
GetExtraButtonCount
GetExtraAxisIndexes
IGameInputDevice

Histórico de versões

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