Fonction XInputGetCapabilities (xinput.h)

Article
10/28/2023

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

Partager via