Syntaxe
Paramètres
info _Out_Type : GameInputArcadeStickInfo* Pointeur vers une structure
GameInputArcadeStickInfo qui reçoit les propriétés de stick arcade du périphérique. Si le périphérique ne prend pas en charge l’entrée de stick arcade, tous les membres de la structure sont définis sur zéro.
Valeur de retour
Type : booltrue si le périphérique prend en charge l’entrée de stick arcade et que info a été renseigné ; sinon, false.
Remarques
La méthodeGetArcadeStickInfo copie les propriétés de stick arcade du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée de stick arcade lorsque la valeur retournée par GetSupportedInput inclut GameInputKindArcadeStick. Si le périphérique ne prend pas en charge l’entrée de stick arcade, GetArcadeStickInfo initialise info à zéro et retourne false.
Les membres d’étiquette décrivent, sous forme de valeurs GameInputLabel, les inscriptions imprimées sur les commandes correspondantes, 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 contrôleur dont dispose le périphérique au-delà du mappage standard du stick arcade ; utilisez GetExtraButtonIndexes et GetExtraAxisIndexes pour les localiser dans l’état de contrôleur d’une lecture. L’état du stick arcade est lu à partir des lectures à l’aide de IGameInputReading::GetArcadeStickState.
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, lors de la connexion du périphérique) et mettre le résultat en cache.
L’exemple suivant montre comment interroger les propriétés de stick arcade d’un périphérique.
arcadeStickInfo 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 GameInputGameInputArcadeStickInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetArcadeStickState
IGameInputDevice