> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDevice::GetControllerAxisLabels

> Recupera las etiquetas de los ejes de mando genéricos del dispositivo.

Recupera las etiquetas de los ejes de mando genéricos del dispositivo.

## Sintaxis

```cpp theme={null}
uint32_t GetControllerAxisLabels(
    uint32_t labelArrayCount,
    GameInputLabel* labelArray
);
```

### 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](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md).

*labelArray*   \_Out\_writes\_to\_opt\_(labelArrayCount, return)\
Tipo: [GameInputLabel](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md)\*

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](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md) que identifica la marca impresa en el eje correspondiente, si el dispositivo la notifica.

Llame a [GetControllerAxisCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md) 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](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md) 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.

```cpp theme={null}
uint32_t axisCount = device->GetControllerAxisCount();
std::vector<GameInputLabel> axisLabels(axisCount);
axisLabels.resize(device->GetControllerAxisLabels(axisCount, axisLabels.data()));

std::vector<float> axisStates(reading->GetControllerAxisCount());
reading->GetControllerAxisState(static_cast<uint32_t>(axisStates.size()), axisStates.data());

for (size_t i = 0; i < axisLabels.size() && i < axisStates.size(); ++i)
{
    // axisLabels[i] is the label of the axis whose value is axisStates[i].
}
```

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `controllerAxisLabels` de la estructura [GameInputControllerInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputcontrollerinfo.md), a la que hacía referencia el miembro `controllerInfo` de la estructura [GameInputDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) devuelta por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## 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](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[GetControllerAxisCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md)\
[GameInputLabel](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetControllerAxisState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

- [GameInputLabel](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md)
- [IGameInputDevice::GetControllerAxisCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md)
- [IGameInputDevice::GetControllerButtonLabels](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttonlabels.md)
- [IGameInputDevice::GetControllerButtonCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerbuttoncount.md)
- [IGameInputDevice::GetControllerSwitchCount](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrollerswitchcount.md)