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 esnullptr 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 aGetControllerAxisLabels 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.
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 SeriesConsulte también
Información general de GameInputGetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice
