Partager via


Fonction XInputGetCapabilities (xinput.h)

Récupère les fonctionnalités d’un contrôleur connecté.

Syntaxe

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

Paramètres

[in] dwUserIndex

Index du contrôleur de l’utilisateur. Il peut s’agir d’une valeur comprise entre 0 et 3. Pour plus d’informations sur la façon dont cette valeur est déterminée et la façon dont la valeur est mappée aux indicateurs sur le contrôleur, consultez Plusieurs contrôleurs.

[in] dwFlags

Indicateurs d’entrée qui identifient le type de contrôleur. Si cette valeur est 0, les fonctionnalités de tous les contrôleurs connectés au système sont retournées. Actuellement, une seule valeur est prise en charge :

Valeur Description
XINPUT_FLAG_GAMEPAD Limitez la requête aux appareils de type contrôleur.
 

Toute valeur de dwflags autre que celle ci-dessus ou 0 est illégale et entraîne un arrêt d’erreur lors du débogage.

[out] pCapabilities

Pointeur vers une structure XINPUT_CAPABILITIES qui reçoit les fonctionnalités du contrôleur.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si le contrôleur n’est pas connecté, la valeur de retour est ERROR_DEVICE_NOT_CONNECTED.

Si la fonction échoue, la valeur de retour est un code d’erreur défini dans WinError.h. La fonction n’utilise pas SetLastError pour définir le code de dernière erreur du thread appelant.

Remarques

Note La version héritée de XINPUT 9.1.0 (incluse dans Windows Vista et versions ultérieures) a toujours retourné un ensemble fixe de fonctionnalités, quel que soit l’appareil attaché.
 

Configuration requise pour la plateforme

Windows 8 (XInput 1.4), directX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)

Configuration requise

   
Plateforme cible Windows
En-tête xinput.h
Bibliothèque Xinput.lib ; Xinput9_1_0.lib
DLL Xinput1_4.dll ; Xinput9_1_0.dll

Voir aussi

Fonctions XInput

XInputGetState

XInputSetState