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. Consultez les sous-types XINPUT et Contrôleur pour obtenir la liste des sous-types autorisés.
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é de retour de force. Notez que ces fonctionnalités de retour de force au-delà du 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 l’appareil d’entrée de texte (TID) ne sont pas pris en charge actuellement via XINPUT sur Windows. |
| XINPUT_CAPS_NO_NAVIGATION | L’appareil n’a pas de boutons de navigation de menu (START, BACK, 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 et résolutions de vibration disponibles.
Notes
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 quelles entrées l’appareil prend en charge. Pour les contrôles d’état binaire, tels que les boutons numériques, le bit correspondant reflète si le contrôle est pris en charge par l’appareil. Pour les contrôles proportionnels, tels que les bâtons de pouce, la valeur indique la résolution de ce contrôle. Un certain nombre de bits les moins significatifs peuvent ne pas être définis, indiquant que le contrôle ne fournit pas de résolution à ce niveau.
Le membre SubType indique le sous-type spécifique du contrôleur présent. Les jeux peuvent détecter le sous-type du contrôleur et régler leur gestion de l’entrée ou de la sortie du contrôleur en fonction des sous-types qui sont bien adaptés à leur genre de jeu. Par exemple, un jeu de course automobile peut vérifier la présence d’un contrôleur de roue pour fournir un contrôle plus fin de la voiture pilotée. 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 réglé doivent être traités comme un manette Xbox 360 standard (XINPUT_DEVSUBTYPE_GAMEPAD).
Les anciens pilotes Windows XUSB signalent des informations sur les fonctionnalités incomplètes, 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
| En-tête | xinput.h |