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 répertorié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 sticks 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 stick 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	Stick arcade. Comprend un stick numérique signalé 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 signalent 0 ou 0xFF. LB, LSB, RB et RSB sont facultatifs.
XINPUT_DEVSUBTYPE_FLIGHT_STICK	Joystick de vol. Comprend un stick de tangage et de roulis signalé comme le stick gauche, un chapeau chinois (POV Hat) signalé comme le stick droit, un palonnier (rotation de la poignée ou bascule) signalé comme la gâchette gauche et une commande des gaz signalée 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 est mappée au DPAD (haut et bas), et les frettes sont affectées à A (vert), B (rouge), Y (jaune), X (bleu) et LB (orange). L’axe Y du stick droit est associé à un capteur d’orientation verticale, et l’axe X du stick droit correspond au 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 frettes) et RSB sont facultatifs. Guitar Bass est identique à Guitar, avec un sous-type distinct pour simplifier la configuration. Guitar Alt 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 affectés aux 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 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 signalent 0 ou 0xFF. Le stick gauche, le stick droit, LSB et RSB sont facultatifs.

Flags
Type : WORD Fonctionnalités de la manette.

Valeur	Description
XINPUT_CAPS_VOICE_SUPPORTED	L’appareil dispose d’un périphérique vocal intégré.
XINPUT_CAPS_FFB_SUPPORTED	L’appareil prend en charge la fonctionnalité de retour de force. Actuellement, 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. Actuellement, les modules enfichables (comme le 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 dispose pas des boutons de navigation dans les menus : START, BACK et DPAD.

Gamepad
Type : XINPUT_GAMEPAD Structure XINPUT_GAMEPAD qui décrit les fonctionnalités et les résolutions de contrôle disponibles sur la manette. Vibration
Type : XINPUT_VIBRATION Structure XINPUT_VIBRATION qui décrit les fonctionnalités et les résolutions de vibration disponibles.

Remarques

XInputGetCapabilities renvoie 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 contrôles à état binaire, tels que les boutons numériques, le bit correspondant indique si le contrôle est pris en charge par l’appareil. Pour les contrôles proportionnels, tels que les sticks, la valeur indique la résolution de ce contrôle. Certains des bits de poids faible peuvent ne pas être définis, pour indiquer que le contrôle ne fournit pas une résolution à ce niveau. Le membre SubType indique le sous-type spécifique de la manette présente. Les jeux peuvent détecter le sous-type de manette et ajuster leur gestion des entrées ou sorties de la manette en fonction des sous-types adaptés à leur genre de jeu. Par exemple, un jeu de course automobile peut vérifier la présence d’un volant pour offrir un contrôle plus précis de la voiture pilotée. 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 Windows XUSB signalent des informations sur des capacités incomplètes, en particulier pour les appareils sans fil. Le pilote Windows XUSB le plus récent offre une prise en charge complète des appareils filaires 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