Pular para o conteúdo principal
Recupera os rótulos dos eixos de controle genérico no dispositivo.

Sintaxe

Parâmetros

labelArrayCount   _In_
Tipo: uint32_t
Número de elementos em labelArray. Para recuperar todos os rótulos de eixos de controle, passe o valor retornado por GetControllerAxisCount. labelArray   _Out_writes_to_opt_(labelArrayCount, return)
Tipo: GameInputLabel*
Ponteiro para uma matriz que recebe um rótulo por eixo de controle. Pode ser nullptr; nesse caso, nada é gravado e o método retorna 0.

Valor retornado

Tipo: uint32_t O número de elementos gravados em labelArray. Esse é o menor valor entre labelArrayCount e o número de rótulos de eixos de controle no dispositivo, ou 0 se labelArray for nullptr ou se o dispositivo não tiver rótulos de eixos de controle.

Comentários

Cada elemento é um valor de GameInputLabel que identifica a marcação impressa no eixo correspondente, se o dispositivo relatar uma. Chame GetControllerAxisCount para obter o número de rótulos de eixos de controle, aloque uma matriz desse tamanho e, em seguida, chame GetControllerAxisLabels para preenchê-la. Se labelArrayCount for menor que o número de rótulos de eixos de controle, somente os primeiros labelArrayCount elementos serão gravados. Os rótulos de eixos de controle de um dispositivo não mudam enquanto o dispositivo está conectado, portanto você pode consultá-los uma vez e armazenar o resultado em cache. O elemento i da matriz de rótulos descreve o eixo no índice i da matriz retornada por IGameInputReading::GetControllerAxisState para leituras desse dispositivo. O exemplo a seguir mostra como recuperar os rótulos de eixos de controle de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro controllerAxisLabels 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
GetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice

Histórico de versões

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