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 :

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

Configuration requise pour la plateforme

Configuration requise

Voir aussi

Fonctions XInput

XInputGetState

XInputSetState