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

> Récupère les propriétés de manche d'arcade du périphérique, comme les étiquettes de ses boutons et des directions de son manche.

Récupère les propriétés de manche d'arcade du périphérique, comme les étiquettes de ses boutons et des directions de son manche.

## Syntaxe

```cpp theme={null}
bool GetArcadeStickInfo(
    GameInputArcadeStickInfo* info
);
```

### Paramètres

*info*   \_Out\_\
Type : [GameInputArcadeStickInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/structs/gameinputarcadestickinfo.md)\*

Pointeur vers une structure `GameInputArcadeStickInfo` qui reçoit les propriétés de manche d'arcade du périphérique. Si le périphérique ne prend pas en charge les entrées de manche d'arcade, tous les membres de la structure sont définis à zéro.

### Valeur de retour

Type : bool

`true` si le périphérique prend en charge les entrées de manche d'arcade et que *info* a été rempli; sinon, `false`.

## Remarques

La méthode `GetArcadeStickInfo` copie les propriétés de manche d'arcade du périphérique dans la structure fournie par l'appelant. Un périphérique prend en charge les entrées de manche d'arcade lorsque la valeur retournée par [GetSupportedInput](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) inclut `GameInputKindArcadeStick`. Si le périphérique ne prend pas en charge les entrées de manche d'arcade, `GetArcadeStickInfo` initialise *info* à zéro et retourne `false`.

Les membres d'étiquette décrivent les marquages imprimés sur les commandes correspondantes, sous forme de valeurs [GameInputLabel](https://docs.xbox.com/fr-CA/reference/input/gameinput/enums/gameinputlabel.md), afin que vous puissiez afficher des invites correspondantes dans votre interface utilisateur. Les membres `extraButtonCount` et `extraAxisCount` indiquent le nombre de boutons et d'axes de manette dont dispose le périphérique au-delà du mappage standard de manche d'arcade; utilisez [GetExtraButtonIndexes](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md) et [GetExtraAxisIndexes](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md) pour les repérer dans l'état de manette d'une lecture. L'état du manche d'arcade est lu à partir des lectures au moyen de [IGameInputReading::GetArcadeStickState](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getarcadestickstate.md).

Les propriétés retournées par cette méthode sont fixes pendant toute la durée de vie du périphérique; vous pouvez donc les interroger une seule fois (par exemple, lorsque le périphérique se connecte) et mettre le résultat en cache.

L'exemple suivant montre comment interroger les propriétés de manche d'arcade d'un périphérique.

```cpp theme={null}
GameInputArcadeStickInfo info;
if (device->GetArcadeStickInfo(&info))
{
    GameInputLabel action1 = info.actionButton1Label;
    // ...
}
```

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre `arcadeStickInfo` 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)\
[GameInputArcadeStickInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/structs/gameinputarcadestickinfo.md)\
[GetSupportedInput](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/fr-CA/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputLabel](https://docs.xbox.com/fr-CA/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetArcadeStickState](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getarcadestickstate.md)\
[IGameInputDevice](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historique des versions

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


## Related topics

- [GameInputArcadeStickInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/structs/gameinputarcadestickinfo.md)
- [IGameInputDevice::GetFlightStickInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getflightstickinfo.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)