Syntaxe
Paramètres
infoArrayCount _In_Type : uint32_t Nombre d’éléments dans infoArray. Pour récupérer tous les commutateurs de manette, 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 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 infoArray. Il s’agit de la plus petite valeur entre infoArrayCount et le nombre de commutateurs de manette du périphérique, ou 0 si infoArray estnullptr ou si le périphérique n’a aucun commutateur de manette.
Remarques
Chaque élément est une structure GameInputControllerSwitchInfo qui décrit le type du commutateur correspondant (2 directions, 4 directions ou 8 directions, sous forme de valeur GameInputSwitchKind) et l’étiquette de chacune de ses positions. Appelez GetControllerSwitchCount pour obtenir le nombre de commutateurs de manette, allouez un tableau de cette taille, puis appelezGetControllerSwitchInfo pour le remplir. Si infoArrayCount est inférieur au nombre de commutateurs de manette, seuls les infoArrayCount premiers éléments sont écrits. Les commutateurs 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’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 manette d’un périphérique.
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 SeriesVoir aussi
Vue d’ensemble de GameInputGetControllerSwitchCount
GameInputControllerSwitchInfo
GameInputSwitchKind
IGameInputReading::GetControllerSwitchState
IGameInputDevice
