Passer au contenu principal
Récupère les propriétés de joystick de vol du périphérique, comme les étiquettes de ses boutons, de son commutateur chapeau et de ses axes.

Syntaxe

Paramètres

info   _Out_
Type : GameInputFlightStickInfo*
Pointeur vers une structure GameInputFlightStickInfo qui reçoit les propriétés de joystick de vol du périphérique. Si le périphérique ne prend pas en charge l’entrée de joystick de vol, 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 joystick de vol et que info a été renseigné ; sinon, false.

Remarques

La méthode GetFlightStickInfo copie les propriétés de joystick de vol du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée de joystick de vol lorsque la valeur retournée par GetSupportedInput inclut GameInputKindFlightStick. Si le périphérique ne prend pas en charge l’entrée de joystick de vol, GetFlightStickInfo initialise info à zéro et retourne false. Les membres d’étiquette décrivent, sous forme de valeurs GameInputLabel, 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 joystick de vol ; utilisez GetExtraButtonIndexes et GetExtraAxisIndexes pour les localiser dans l’état de contrôleur d’une lecture. L’état du joystick de vol est lu à partir des lectures à l’aide de IGameInputReading::GetFlightStickState. 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 joystick de vol d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre flightStickInfo 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
GameInputFlightStickInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetFlightStickState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026