structure XINPUT_CAPABILITIES (xinput.h)
Décrit les fonctionnalités d’un contrôleur connecté. La fonction XInputGetCapabilities retourne XINPUT_CAPABILITIES.
Syntaxe
typedef struct _XINPUT_CAPABILITIES {
BYTE Type;
BYTE SubType;
WORD Flags;
XINPUT_GAMEPAD Gamepad;
XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;
Membres
Type
Type de contrôleur. Il doit s’agir de l’une des valeurs suivantes.
| Valeur | Description |
|---|---|
| XINPUT_DEVTYPE_GAMEPAD | L’appareil est un contrôleur de jeu. |
SubType
Sous-type du contrôleur de jeu. Pour obtenir la liste des sous-types autorisés, consultez Sous-types XINPUT et controller .
Flags
Fonctionnalités du contrôleur.
| Valeur | Description |
|---|---|
| XINPUT_CAPS_VOICE_SUPPORTED | L’appareil dispose d’un appareil vocal intégré. |
| XINPUT_CAPS_FFB_SUPPORTED | L’appareil prend en charge la fonctionnalité forcer la rétroaction. Notez que ces fonctionnalités de rétroaction forcée au-delà de Rumble ne sont actuellement pas prises en charge par le biais de XINPUT sur Windows. |
| XINPUT_CAPS_WIRELESS | L’appareil est sans fil. |
| XINPUT_CAPS_PMD_SUPPORTED | L’appareil prend en charge les modules de plug-in. Notez que les modules de plug-in comme le périphérique d’entrée de texte (TID) ne sont actuellement pas pris en charge via XINPUT sur Windows. |
| XINPUT_CAPS_NO_NAVIGATION | L’appareil ne dispose pas de boutons de navigation de menu (DÉMARRER, PRÉCÉDENT, DPAD). |
Gamepad
XINPUT_GAMEPAD structure qui décrit les fonctionnalités de contrôleur disponibles et les résolutions de contrôle.
Vibration
XINPUT_VIBRATION structure qui décrit les fonctionnalités de vibration et les résolutions disponibles.
Remarques
XInputGetCapabilities retourne XINPUT_CAPABILITIES pour indiquer les caractéristiques et les fonctionnalités disponibles d’un contrôleur spécifié.
XInputGetCapabilities définit les membres de la structure pour indiquer les entrées que l’appareil prend en charge. Pour les contrôles d’état binaires, tels que les boutons numériques, le bit correspondant indique si le contrôle est pris en charge ou non par l’appareil. Pour les contrôles proportionnels, tels que les manettes, la valeur indique la résolution de ce contrôle. Un certain nombre de bits les moins significatifs peuvent ne pas être définis, ce qui indique que le contrôle ne fournit pas de résolution à ce niveau.
Le membre SubType indique le sous-type spécifique de contrôleur présent. Les jeux peuvent détecter le sous-type de contrôleur et régler leur gestion de l’entrée ou de la sortie du contrôleur en fonction de sous-types bien adaptés à leur genre de jeu. Par exemple, un jeu de course de voiture peut case activée pour la présence d’un contrôleur de roue pour fournir un contrôle plus précis de la voiture conduite. Toutefois, les titres ne doivent pas désactiver ou ignorer un appareil en fonction de son sous-type. Les sous-types non reconnus par le jeu ou pour lesquels le jeu n’est pas spécifiquement accordé doivent être traités comme un contrôleur standard (XINPUT_DEVSUBTYPE_GAMEPAD).
Les pilotes Windows XUSB plus anciens signalent des informations incomplètes sur les fonctionnalités, en particulier pour les appareils sans fil. Le dernier pilote Windows XUSB offre une prise en charge complète des appareils câblés et sans fil, ainsi que des indicateurs de fonctionnalités plus complets et précis.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | xinput.h |