Syntaxe
Paramètres
info _Out_Type : GameInputGamepadInfo* Pointeur vers une structure
GameInputGamepadInfo qui reçoit les propriétés de manette de jeu du périphérique. Si le périphérique ne prend pas en charge l’entrée de manette de jeu, chaque membre de la structure est mis à zéro.
Valeur de retour
Type : booltrue si le périphérique prend en charge l’entrée de manette de jeu et que info a été rempli; sinon, false.
Remarques
La méthodeGetGamepadInfo copie les propriétés de manette de jeu du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée de manette de jeu lorsque la valeur retournée par GetSupportedInput inclut GameInputKindGamepad. Si le périphérique ne prend pas en charge l’entrée de manette de jeu, GetGamepadInfo initialise info à zéro et retourne false.
Le membre supportedLayout est une combinaison d’indicateurs GameInputGamepadButtons qui indique quels boutons de manette de jeu standard le périphérique possède. Les membres d’étiquette décrivent les marquages imprimés sur les commandes correspondantes, sous forme de valeurs GameInputLabel, afin que vous puissiez afficher des invites correspondantes dans votre interface utilisateur. Les membres extraButtonCount et extraAxisCount indiquent le nombre de boutons et d’axes de manette dont dispose le périphérique au-delà du mappage de manette de jeu standard; utilisez GetExtraButtonIndexes et GetExtraAxisIndexes pour les repérer dans l’état de manette d’une lecture. L’état de la manette de jeu se lit à partir des lectures à l’aide de IGameInputReading::GetGamepadState.
Les propriétés retournées par cette méthode sont fixes pendant toute la durée de vie du périphérique; vous pouvez donc les interroger une seule fois (par exemple, lorsque le périphérique se connecte) et mettre le résultat en cache.
L’exemple suivant montre comment interroger les propriétés de manette de jeu d’un périphérique.
gamepadInfo 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 GameInputGameInputGamepadInfo
GetSupportedInput
GameInputKind
GameInputGamepadButtons
GameInputLabel
IGameInputReading::GetGamepadState
IGameInputDevice