Saltar al contenido principal
Recupera las etiquetas de los botones 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 botones de mando, pase el valor devuelto por GetControllerButtonCount. labelArray   _Out_writes_to_opt_(labelArrayCount, return)
Tipo: GameInputLabel*
Puntero a una matriz que recibe una etiqueta por cada botón 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 botones de mando del dispositivo, o 0 si labelArray es nullptr o el dispositivo no tiene etiquetas de botones de mando.

Comentarios

Cada elemento es un valor de GameInputLabel que identifica la marca impresa en el botón correspondiente, si el dispositivo la notifica. Llame a GetControllerButtonCount para obtener el número de etiquetas de botones de mando, asigne una matriz de ese tamaño y, a continuación, llame a GetControllerButtonLabels para rellenarla. Si labelArrayCount es menor que el número de etiquetas de botones de mando, solo se escriben los primeros labelArrayCount elementos. Las etiquetas de los botones 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 botón situado en el índice i de la matriz devuelta por IGameInputReading::GetControllerButtonState para las lecturas de este dispositivo. En el siguiente ejemplo se muestra cómo recuperar las etiquetas de los botones de mando de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro controllerButtonLabels 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
GetControllerButtonCount
GameInputLabel
IGameInputReading::GetControllerButtonState
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026