Syntaxe
Paramètres
labelArrayCount _In_Type : uint32_t Nombre d’éléments dans labelArray. Pour récupérer toutes les étiquettes d’axes de manette, 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 manette. Peut être
nullptr; dans ce cas, rien n’est écrit et la méthode retourne 0.
Valeur de retour
Type : uint32_t Le nombre d’éléments écrits dans labelArray. Il s’agit de la plus petite valeur entre labelArrayCount et le nombre d’étiquettes d’axes de manette du périphérique, ou 0 si labelArray estnullptr ou si le périphérique n’a aucune étiquette d’axe de manette.
Remarques
Chaque élément est une valeur GameInputLabel qui identifie le marquage imprimé sur l’axe correspondant, si le périphérique en signale un. Appelez GetControllerAxisCount pour obtenir le nombre d’étiquettes d’axes de manette, allouez un tableau de cette taille, puis appelezGetControllerAxisLabels pour le remplir. Si labelArrayCount est inférieur au nombre d’étiquettes d’axes de manette, seuls les labelArrayCount premiers éléments sont écrits. Les étiquettes d’axes de manette 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 d’axes de manette d’un périphérique.
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 SeriesVoir aussi
Vue d’ensemble de GameInputGetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice
