Passer au contenu principal
Récupère les étiquettes des axes de contrôleur génériques du périphérique.

Syntaxe

Paramètres

labelArrayCount   _In_
Type : uint32_t
Nombre d’éléments de labelArray. Pour récupérer toutes les étiquettes des axes de contrôleur, transmettez la valeur retournée par GetControllerAxisCount. labelArray   _Out_writes_to_opt_(labelArrayCount, return)
Type : GameInputLabel*
Pointeur vers un tableau qui reçoit une étiquette par axe de contrôleur. Peut être nullptr, auquel cas rien n’est écrit et la méthode retourne 0.

Valeur de retour

Type : uint32_t Nombre d’éléments écrits dans labelArray. Il s’agit de la plus petite valeur entre labelArrayCount et le nombre d’étiquettes des axes de contrôleur du périphérique, ou de 0 si labelArray est nullptr ou si le périphérique n’a aucune étiquette d’axe de contrôleur.

Remarques

Chaque élément est une valeur GameInputLabel qui identifie l’inscription imprimée sur l’axe correspondant, si le périphérique en signale une. Appelez GetControllerAxisCount pour obtenir le nombre d’étiquettes des axes de contrôleur, allouez un tableau de cette taille, puis appelez GetControllerAxisLabels pour le remplir. Si labelArrayCount est inférieur au nombre d’étiquettes des axes de contrôleur, seuls les labelArrayCount premiers éléments sont écrits. Les étiquettes des axes de contrôleur 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 pour les lectures de ce périphérique. L’exemple suivant montre comment récupérer les étiquettes des axes de contrôleur d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre controllerAxisLabels de la structure GameInputControllerInfo, référencée par le membre controllerInfo 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
GetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026