> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XInputGetCapabilities

> XInputGetCapabilities

# XInputGetCapabilities

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

## Syntaxe

```cpp theme={null}
DWORD XInputGetCapabilities(  
         DWORD dwUserIndex,  
         DWORD dwFlags,  
         XINPUT_CAPABILITIES * pCapabilities  
)  
```

### 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](/fr-CA/reference/input/xinputongameinput/structs/xinput_capabilities)\*

Pointeur vers un objet [XINPUT\_CAPABILITIES](/fr-CA/reference/input/xinputongameinput/structs/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

> [!NOTE]
>
> 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](/fr-CA/reference/input/xinputongameinput/structs/xinput_capabilities).

Pour plus d'informations, consultez [Le wrapper XInputOnGameInput](/fr-CA/build/core-features/common/input/porting/input-porting-xinput#xinputWrapperSection).

## 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](/fr-CA/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/fr-CA/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_CAPABILITIES](/fr-CA/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputOnGameInput (contenu de l'API)](/fr-CA/reference/input/xinputongameinput/xinputongameinput_members.md)
- [GameInputDeviceCapabilities (déprécié)](/fr-CA/reference/input/gameinput/deprecated/enums/gameinputdevicecapabilities.md)
- [Dynamic Latency Input de GameInput](/fr-CA/build/core-features/common/input/advanced/input-synchronization.md)
- [GameInputDeviceInfo](/fr-CA/reference/input/gameinput/structs/gameinputdeviceinfo.md)