> ## 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

> Récupère les étiquettes des axes de manette générique du périphérique.

Récupère les étiquettes des axes de manette générique du périphérique.

## Syntaxe

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

### Paramètres

*labelArrayCount*   \_In\_\
Type : uint32\_t

Nombre d'éléments dans *labelArray*. Pour récupérer toutes les étiquettes d'axes de manette, transmettez la valeur retournée par [GetControllerAxisCount](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md).

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

Pointeur vers un tableau qui reçoit une étiquette par axe de manette. Peut être `nullptr`; dans ce cas, rien n'est écrit et la méthode retourne 0.

### Valeur de retour

Type : uint32\_t

Le nombre d'éléments écrits dans *labelArray*. Il s'agit de la plus petite valeur entre *labelArrayCount* et le nombre d'étiquettes d'axes de manette du périphérique, ou 0 si *labelArray* est `nullptr` ou si le périphérique n'a aucune étiquette d'axe de manette.

## Remarques

Chaque élément est une valeur [GameInputLabel](https://docs.xbox.com/fr-CA/reference/input/gameinput/enums/gameinputlabel.md) qui identifie le marquage imprimé sur l'axe correspondant, si le périphérique en signale un.

Appelez [GetControllerAxisCount](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md) pour obtenir le nombre d'étiquettes d'axes de manette, allouez un tableau de cette taille, puis appelez `GetControllerAxisLabels` pour le remplir. Si *labelArrayCount* est inférieur au nombre d'étiquettes d'axes de manette, seuls les *labelArrayCount* premiers éléments sont écrits. Les étiquettes d'axes de manette d'un périphérique ne changent pas tant que le périphérique est connecté; vous pouvez donc les interroger une seule fois et mettre le résultat en cache.

L'élément *i* du tableau d'étiquettes décrit l'axe situé à l'index *i* du tableau retourné par [IGameInputReading::GetControllerAxisState](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md) pour les lectures de ce périphérique.

L'exemple suivant montre comment récupérer les étiquettes d'axes de manette d'un périphérique.

```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].
}
```

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre `controllerAxisLabels` de la structure [GameInputControllerInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/structs/gameinputcontrollerinfo.md), référencée par le membre `controllerInfo` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Configuration requise

**En-tête :** GameInput.h

**Bibliothèque :** gameinput.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-overview.md)\
[GetControllerAxisCount](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontrolleraxiscount.md)\
[GameInputLabel](https://docs.xbox.com/fr-CA/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetControllerAxisState](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)\
[IGameInputDevice](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduit. |


## Related topics

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