Partager via


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 .

Note Pour connaître les restrictions relatives à l’utilisation de cette valeur de sous-type, consultez Remarques. D’autres sous-types peuvent être ajoutés à l’avenir.
 

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

Voir aussi

XINPUT_GAMEPAD

XINPUT_VIBRATION

XInput Structures

XInputGetCapabilities