Passer au contenu principal

XInputGetCapabilities

Récupère les capacités et les fonctionnalités d’une manette connectée.

Syntaxe

Paramètres

dwUserIndex   _In_
Type : DWORD
Index du joueur associé à l’appareil; valeur comprise entre 0 et XUSER_MAX_COUNT - 1. dwFlags   _In_
Type : DWORD
Indicateurs d’entrée qui identifient le type de manette. Si cette valeur est 0, les capacités de toutes les manettes connectées au système sont retournées. Actuellement, seul XINPUT_FLAG_GAMEPAD est pris en charge. pCapabilities   _Out_
Type : XINPUT_CAPABILITIES*
Pointeur vers un objet XINPUT_CAPABILITIES qui reçoit les capacités de la manette.

Valeur de retour

Type : DWORD Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Si la manette n’est pas connectée, 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

L’ancienne version XINPUT 9.1.0 (incluse dans Windows Vista et les versions ultérieures) retournait toujours un ensemble fixe de capacités, quel que soit l’appareil connecté.
Pour plus de détails sur les capacités signalées, consultez XINPUT_CAPABILITIES. Pour plus d’informations, consultez Le wrapper XInputOnGameInput.

Configuration requise

En-tête : XInputOnGameInput.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Portage d’XInput vers GameInput
XInputOnGameInput
Dernière modification le 6 octobre 2026