Passer au contenu principal

GetExtraButtonCount

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

Syntaxe

Paramètres

inputKind   _In_
Type : GameInputKind
Type d’entrée dont le nombre de boutons supplémentaires est demandé. extraButtonCount   _Out_
Type : uint32_t*
Nombre de boutons supplémentaires, ou boutons non pris en charge, présents sur le périphérique 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 le périphérique physique mais qui ne font pas partie du mappage standard du type d’entrée spécifié. Cette méthode est utile pour les applications qui souhaitent accéder à des boutons propres au périphérique, 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 spécifiques de ces boutons supplémentaires et pour réserver l’espace adéquat afin de stocker les index de bouton 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 19 octobre 2026