> ## 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 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](/fr/reference/input/xinputongameinput/structs/xinput_gamepad)

Structure [XINPUT\_GAMEPAD](/fr/reference/input/xinputongameinput/structs/xinput_gamepad) qui décrit les fonctionnalités et les résolutions de contrôle disponibles sur la manette.

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

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

## Remarques

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

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