Saltar al contenido principal
Recupera las etiquetas de los ejes de mando genéricos del dispositivo.

Sintaxis

Parámetros

labelArrayCount   _In_
Tipo: uint32_t
Número de elementos de labelArray. Para recuperar todas las etiquetas de los ejes de mando, pase el valor devuelto por GetControllerAxisCount. labelArray   _Out_writes_to_opt_(labelArrayCount, return)
Tipo: GameInputLabel*
Puntero a una matriz que recibe una etiqueta por cada eje de mando. Puede ser nullptr, en cuyo caso no se escribe nada y el método devuelve 0.

Valor devuelto

Tipo: uint32_t El número de elementos escritos en labelArray. Es el menor de labelArrayCount y el número de etiquetas de ejes de mando del dispositivo, o 0 si labelArray es nullptr o el dispositivo no tiene etiquetas de ejes de mando.

Comentarios

Cada elemento es un valor de GameInputLabel que identifica la marca impresa en el eje correspondiente, si el dispositivo la notifica. Llame a GetControllerAxisCount para obtener el número de etiquetas de ejes de mando, asigne una matriz de ese tamaño y, a continuación, llame a GetControllerAxisLabels para rellenarla. Si labelArrayCount es menor que el número de etiquetas de ejes de mando, solo se escriben los primeros labelArrayCount elementos. Las etiquetas de los ejes de mando de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlas una vez y almacenar en caché el resultado. El elemento i de la matriz de etiquetas describe el eje situado en el índice i de la matriz devuelta por IGameInputReading::GetControllerAxisState para las lecturas de este dispositivo. En el siguiente ejemplo se muestra cómo recuperar las etiquetas de los ejes de mando de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro controllerAxisLabels de la estructura GameInputControllerInfo, a la que hacía referencia el miembro controllerInfo de la estructura GameInputDeviceInfo devuelta por IGameInputDevice::GetDeviceInfo.

Requisitos

Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Información general de GameInput
GetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026