Passer au contenu principal
Récupère des informations sur les commutateurs de contrôleur génériques du périphérique, comme les commutateurs chapeau et les croix directionnelles.

Syntaxe

Paramètres

infoArrayCount   _In_
Type : uint32_t
Nombre d’éléments de infoArray. Pour récupérer tous les commutateurs de contrôleur, transmettez la valeur retournée par GetControllerSwitchCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Type : GameInputControllerSwitchInfo*
Pointeur vers un tableau qui reçoit une structure par commutateur 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 infoArray. Il s’agit de la plus petite valeur entre infoArrayCount et le nombre de commutateurs de contrôleur du périphérique, ou de 0 si infoArray est nullptr ou si le périphérique n’a aucun commutateur de contrôleur.

Remarques

Chaque élément est une structure GameInputControllerSwitchInfo qui décrit le type du commutateur correspondant (à deux, quatre ou huit positions, sous forme de valeur GameInputSwitchKind) ainsi que l’étiquette de chacune de ses positions. Appelez GetControllerSwitchCount pour obtenir le nombre de commutateurs de contrôleur, allouez un tableau de cette taille, puis appelez GetControllerSwitchInfo pour le remplir. Si infoArrayCount est inférieur au nombre de commutateurs de contrôleur, seuls les infoArrayCount premiers éléments sont écrits. Les commutateurs 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’informations décrit le commutateur situé à l’index i du tableau retourné par IGameInputReading::GetControllerSwitchState pour les lectures de ce périphérique. L’exemple suivant montre comment récupérer les commutateurs de contrôleur d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre controllerSwitchInfo 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
GetControllerSwitchCount
GameInputControllerSwitchInfo
GameInputSwitchKind
IGameInputReading::GetControllerSwitchState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026