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

> Récupère les propriétés de volant de course du périphérique, comme les étiquettes de ses commandes, ses pédales, son levier de vitesses et l'angle maximal du volant.

Récupère les propriétés de volant de course du périphérique, comme les étiquettes de ses commandes, ses pédales, son levier de vitesses et l'angle maximal du volant.

## Syntaxe

```cpp theme={null}
bool GetRacingWheelInfo(
    GameInputRacingWheelInfo* info
);
```

### Paramètres

*info*   \_Out\_\
Type : [GameInputRacingWheelInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputracingwheelinfo.md)\*

Pointeur vers une structure `GameInputRacingWheelInfo` qui reçoit les propriétés de volant de course du périphérique. Si le périphérique ne prend pas en charge l'entrée de volant de course, tous les membres de la structure sont définis sur zéro.

### Valeur de retour

Type : bool

`true` si le périphérique prend en charge l'entrée de volant de course et que *info* a été renseigné ; sinon, `false`.

## Remarques

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

Les membres `hasClutch`, `hasHandbrake` et `hasPatternShifter` indiquent les commandes facultatives présentes, `minPatternShifterGear` et `maxPatternShifterGear` donnent la plage de rapports du levier de vitesses à grille, et `maxWheelAngle` donne la rotation maximale du volant. Les membres d'étiquette décrivent, sous forme de valeurs [GameInputLabel](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputlabel.md), les inscriptions imprimées sur les commandes correspondantes, 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 contrôleur dont dispose le périphérique au-delà du mappage standard du volant de course ; utilisez [GetExtraButtonIndexes](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md) et [GetExtraAxisIndexes](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md) pour les localiser dans l'état de contrôleur d'une lecture. L'état du volant de course est lu à partir des lectures à l'aide de [IGameInputReading::GetRacingWheelState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getracingwheelstate.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, lors de la connexion du périphérique) et mettre le résultat en cache.

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

```cpp theme={null}
GameInputRacingWheelInfo info;
if (device->GetRacingWheelInfo(&info))
{
    if (info.hasClutch)
    {
        // Enable manual clutch controls.
    }
}
```

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre `racingWheelInfo` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr/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/build/core-features/common/input/overviews/input-overview.md)\
[GameInputRacingWheelInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputracingwheelinfo.md)\
[GetSupportedInput](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputLabel](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetRacingWheelState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getracingwheelstate.md)\
[IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduite. |


## Related topics

- [GameInputRacingWheelInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputracingwheelinfo.md)
- [IGameInputDevice::GetMouseInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getmouseinfo.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)