Syntaxe
Paramètres
labelArrayCount _In_Type : uint32_t Nombre d’éléments de labelArray. Pour récupérer toutes les étiquettes des boutons de contrôleur, transmettez la valeur retournée par GetControllerButtonCount. labelArray _Out_writes_to_opt_(labelArrayCount, return)
Type : GameInputLabel* Pointeur vers un tableau qui reçoit une étiquette par bouton 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 boutons de contrôleur du périphérique, ou de 0 si labelArray estnullptr ou si le périphérique n’a aucune étiquette de bouton de contrôleur.
Remarques
Chaque élément est une valeur GameInputLabel qui identifie l’inscription imprimée sur le bouton correspondant, si le périphérique en signale une. Appelez GetControllerButtonCount pour obtenir le nombre d’étiquettes des boutons de contrôleur, allouez un tableau de cette taille, puis appelezGetControllerButtonLabels pour le remplir. Si labelArrayCount est inférieur au nombre d’étiquettes des boutons de contrôleur, seuls les labelArrayCount premiers éléments sont écrits. Les étiquettes des boutons 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 le bouton situé à l’index i du tableau retourné par IGameInputReading::GetControllerButtonState pour les lectures de ce périphérique.
L’exemple suivant montre comment récupérer les étiquettes des boutons de contrôleur d’un périphérique.
controllerButtonLabels 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 GameInputGetControllerButtonCount
GameInputLabel
IGameInputReading::GetControllerButtonState
IGameInputDevice
