Pular para o conteúdo principal

GetExtraAxisIndexes

Obtém os índices de eixo do controle dos eixos extras no dispositivo para um determinado tipo de entrada.

Sintaxe

Parâmetros

inputKind   _In_
Tipo: GameInputKind
O tipo de entrada cujos índices de eixos extras estão sendo solicitados. extraAxisCount   _In_
Tipo: uint32_t
Contagem esperada de índices de eixo para eixos extras. Esse número pode ser recuperado chamando GetExtraAxisCount. extraAxisIndexes   _Out_writes_(extraAxisCount)_
Tipo: uint8_t*
Ponteiro para a matriz de índices de eixo.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

O método GetExtraAxisIndexes recupera os índices de eixo do controle dos eixos extras presentes no dispositivo para um determinado tipo de entrada. Eixos extras são eixos 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 GetExtraAxisCount para determinar quantos eixos extras estão disponíveis e passar essa contagem como o parâmetro extraAxisCount. O exemplo de código a seguir demonstra como usar os eixos 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
GetExtraAxisCount
GetExtraButtonIndexes
IGameInputDevice

Histórico de versões

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