XINPUT_CAPABILITIES

Décrit les capacités d’une manette connectée.

Syntaxe

typedef struct XINPUT_CAPABILITIES {  
    BYTE Type;  
    BYTE SubType;  
    WORD Flags;  
    XINPUT_GAMEPAD Gamepad;  
    XINPUT_VIBRATION Vibration;  
} XINPUT_CAPABILITIES  

Membres

Type
Type : BYTE Type de manette. Il doit être de type XINPUT_DEVTYPE_GAMEPAD et avoir l’une des valeurs indiquées dans le tableau ci-dessous. SubType
Type : BYTE Sous-type de la manette de jeu. Sous-types autorisés :

Sous-type	Signification
XINPUT_DEVSUBTYPE_UNKNOWN	Inconnu. Le type de manette est inconnu.
XINPUT_DEVSUBTYPE_GAMEPAD	Manette de jeu. Comprend les joysticks gauche et droit, les gâchettes gauche et droite, le pavé directionnel et tous les boutons standard : A, B, X, Y, START, BACK, LB, RB, LSB et RSB.
XINPUT_DEVSUBTYPE_WHEEL	Volant de course. L’axe X du joystick gauche indique la rotation du volant, la gâchette droite correspond à la pédale d’accélérateur et la gâchette gauche, à la pédale de frein. Le pavé directionnel et la plupart des boutons standard sont inclus : A, B, X, Y, START, BACK, LB et RB. LSB et RSB sont facultatifs.
XINPUT_DEVSUBTYPE_ARCADE_STICK	Manette d’arcade. Comprend un joystick numérique qui se signale comme un DPAD (haut, bas, gauche et droite) et la plupart des boutons standard : A, B, X, Y, START et BACK. Les gâchettes gauche et droite sont implémentées comme des boutons numériques et indiquent 0 ou 0xFF. LB, LSB, RB et RSB sont facultatifs.
XINPUT_DEVSUBTYPE_FLIGHT_STICK	Manche à balai. Comprend un manche de tangage et de roulis qui se signale comme le joystick gauche, un chapeau chinois (POV) qui se signale comme le joystick droit, un palonnier (rotation de la poignée ou bascule) qui se signale comme la gâchette gauche et une commande des gaz comme la gâchette droite. Prend en charge une arme principale (A), une arme secondaire (B) et d’autres boutons standard : X, Y, START et BACK. LB, LSB, RB et RSB sont facultatifs.
XINPUT_DEVSUBTYPE_DANCE_PAD	Tapis de danse. Comprend le pavé directionnel et les boutons standard (A, B, X et Y) sur le tapis, ainsi que BACK et START.
XINPUT_DEVSUBTYPE_GUITAR XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE XINPUT_DEVSUBTYPE_GUITAR_BASS	Manette guitare. La barre de grattage correspond au DPAD (haut et bas), et les frettes sont attribuées à A (vert), B (rouge), Y (jaune), X (bleu) et LB (orange). L’axe Y du joystick droit est associé à un capteur d’orientation verticale, et l’axe X du joystick droit correspond au levier de vibrato. BACK, START et le DPAD (gauche, droite) sont pris en charge. La gâchette gauche (sélecteur de micro), la gâchette droite, RB, LSB (modificateur de frette) et RSB sont facultatifs. La guitare basse est identique à la guitare, avec un sous-type distinct pour simplifier la configuration. La guitare alternative prend en charge une plus grande amplitude de mouvement pour le capteur d’orientation verticale.
XINPUT_DEVSUBTYPE_DRUM_KIT	Manette batterie. Les pads de batterie sont attribués à des boutons : A pour le vert (tom basse), B pour le rouge (caisse claire), X pour le bleu (tom grave), Y pour le jaune (tom aigu) et LB pour la pédale (grosse caisse). Le pavé directionnel, BACK et START sont inclus. RB, LSB et RSB sont facultatifs.
XINPUT_DEVSUBTYPE_ARCADE_PAD	Manette de type arcade. Comprend le pavé directionnel et la plupart des boutons standard : A, B, X, Y, START, BACK, LB et RB. Les gâchettes gauche et droite sont implémentées comme des boutons numériques et indiquent 0 ou 0xFF. Le joystick gauche, le joystick droit, LSB et RSB sont facultatifs.

Flags
Type : WORD Fonctionnalités de la manette.

Valeur	Description
XINPUT_CAPS_VOICE_SUPPORTED	L’appareil possède un dispositif vocal intégré.
XINPUT_CAPS_FFB_SUPPORTED	L’appareil prend en charge le retour de force. Pour le moment, les fonctionnalités de retour de force autres que la vibration ne sont pas prises en charge par XINPUT sur Windows.
XINPUT_CAPS_WIRELESS	L’appareil est sans fil.
XINPUT_CAPS_PMD_SUPPORTED	L’appareil prend en charge les modules enfichables. Pour le moment, les modules enfichables (comme un périphérique de saisie de texte (TID)) ne sont pas pris en charge par XINPUT sur Windows.
XINPUT_CAPS_NO_NAVIGATION	L’appareil ne possède pas les boutons de navigation dans les menus : START, BACK et DPAD.

Gamepad
Type : XINPUT_GAMEPAD Structure XINPUT_GAMEPAD qui décrit les fonctionnalités de manette disponibles et les résolutions des commandes. Vibration
Type : XINPUT_VIBRATION Structure XINPUT_VIBRATION qui décrit les fonctionnalités de vibration disponibles et leurs résolutions.

Remarques

XInputGetCapabilities retourne XINPUT_CAPABILITIES pour indiquer les caractéristiques et les fonctionnalités disponibles d’une manette spécifiée. XInputGetCapabilities définit les membres de la structure pour indiquer les entrées prises en charge par l’appareil. Pour les commandes à état binaire, comme les boutons numériques, le bit correspondant indique si la commande est prise en charge par l’appareil. Pour les commandes proportionnelles, comme les joysticks, la valeur indique la résolution de cette commande. Un certain nombre de bits de poids faible peuvent ne pas être définis, pour indiquer que la commande n’offre pas de résolution à ce niveau. Le membre SubType indique le sous-type précis de la manette présente. Les jeux peuvent détecter le sous-type de la manette et ajuster leur gestion des entrées ou des sorties de la manette selon les sous-types bien adaptés à leur genre de jeu. Par exemple, un jeu de course automobile pourrait vérifier la présence d’un volant pour offrir un contrôle plus fin de la voiture conduite. Toutefois, les titres ne doivent pas désactiver ni ignorer un appareil en fonction de son sous-type. Un sous-type non reconnu par le jeu, ou pour lequel le jeu n’est pas spécifiquement ajusté, doit être traité comme une manette standard, XINPUT_DEVSUBTYPE_GAMEPAD. Les anciens pilotes XUSB pour Windows signalent des informations incomplètes sur les capacités, en particulier pour les appareils sans fil. Le pilote XUSB pour Windows le plus récent offre une prise en charge complète des appareils avec fil et sans fil, et fournit des indicateurs de capacités plus complets et plus précis.

Configuration requise

En-tête : XInputOnGameInput.h Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Porter XInput vers GameInput
XInputOnGameInput

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XINPUT_CAPABILITIES

XINPUT_CAPABILITIES

Syntaxe

Membres

Remarques

Configuration requise

Voir aussi

​XINPUT_CAPABILITIES

​Syntaxe

​Membres

​Remarques

​Configuration requise

​Voir aussi

XINPUT_CAPABILITIES

Syntaxe

Membres

Remarques

Configuration requise

Voir aussi