Passer au contenu principal

GetExtraButtonCount

Obtient le nombre de boutons supplémentaires, ou boutons non pris en charge, présents sur l’appareil pour un type d’entrée donné.

Syntaxe

Paramètres

inputKind   _In_
Type : GameInputKind
Le type d’entrée dont le nombre de boutons supplémentaires est demandé. extraButtonCount   _Out_
Type : uint32_t*
Le nombre de boutons supplémentaires, ou boutons non pris en charge, présents sur l’appareil pour le type d’entrée spécifié.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Les boutons supplémentaires sont des boutons de contrôleur qui existent sur l’appareil physique, mais qui ne font pas partie du mappage standard pour le type d’entrée spécifié. Cette méthode est utile pour les applications qui veulent accéder à des boutons propres à l’appareil allant au-delà du mappage d’entrée standard. Le nombre obtenu est destiné à être utilisé avec la méthode GetExtraButtonIndexes pour récupérer les index précis de ces boutons supplémentaires et pour réserver l’espace de mémoire tampon adéquat afin de stocker les index de boutons fournis par cette méthode.

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

GameInputKind
GetExtraButtonIndexes
GetExtraAxisCount
IGameInputDevice

Historique des versions

Dernière modification le 6 octobre 2026