Passer au contenu principal
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

Paramètres

info   _Out_
Type : GameInputRacingWheelInfo*
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, chaque membre de la structure est mis à 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é rempli; 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 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 quelles commandes facultatives sont présentes, minPatternShifterGear et maxPatternShifterGear indiquent la plage de rapports du levier de vitesses à grille, et maxWheelAngle indique la rotation maximale du volant. Les membres d’étiquette décrivent les marquages imprimés sur les commandes correspondantes, sous forme de valeurs GameInputLabel, 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 de volant de course standard; utilisez GetExtraButtonIndexes et GetExtraAxisIndexes pour les repérer dans l’état de manette d’une lecture. L’état du volant de course se lit à partir des lectures à l’aide de IGameInputReading::GetRacingWheelState. 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 volant de course d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre racingWheelInfo de la structure GameInputDeviceInfo retournée par IGameInputDevice::GetDeviceInfo.

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
GameInputRacingWheelInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetRacingWheelState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026