> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XINPUT_CAPABILITIES

> XINPUT_CAPABILITIES

# XINPUT\_CAPABILITIES

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

## Syntaxe

```cpp theme={null}
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](/fr-CA/reference/input/xinputongameinput/structs/xinput_gamepad)

Structure [XINPUT\_GAMEPAD](/fr-CA/reference/input/xinputongameinput/structs/xinput_gamepad) qui décrit les fonctionnalités de manette disponibles et les résolutions des commandes.

*Vibration*\
Type : [XINPUT\_VIBRATION](/fr-CA/reference/input/xinputongameinput/structs/xinput_vibration)

Structure [XINPUT\_VIBRATION](/fr-CA/reference/input/xinputongameinput/structs/xinput_vibration) qui décrit les fonctionnalités de vibration disponibles et leurs résolutions.

## Remarques

[XInputGetCapabilities](/fr-CA/reference/input/xinputongameinput/functions/xinputgetcapabilities) retourne XINPUT\_CAPABILITIES pour indiquer les caractéristiques et les fonctionnalités disponibles d'une manette spécifiée.

[XInputGetCapabilities](/fr-CA/reference/input/xinputongameinput/functions/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](/fr-CA/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/fr-CA/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_CAPABILITIES](/zh-CN/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputGetCapabilities](/reference/input/xinputongameinput/functions/xinputgetcapabilities.md)
