> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 renvoyées. Actuellement, seul `XINPUT_FLAG_GAMEPAD` est pris en charge.

*pCapabilities*   \_Out\_\
Type : [XINPUT\_CAPABILITIES](https://docs.xbox.com/fr/reference/input/xinputongameinput/structs/xinput_capabilities.md)\*

Pointeur vers un objet [XINPUT\_CAPABILITIES](https://docs.xbox.com/fr/reference/input/xinputongameinput/structs/xinput_capabilities.md) qui reçoit les capacités de la manette.

### Valeur renvoyée

Type : DWORD

Si la fonction réussit, la valeur renvoyée est `ERROR_SUCCESS`.

Si la manette n'est pas connectée, la valeur renvoyée est `ERROR_DEVICE_NOT_CONNECTED`.

Si la fonction échoue, la valeur renvoyée est un code d'erreur défini dans WinError.h. La fonction n'utilise pas `SetLastError` pour définir le dernier code d'erreur du thread appelant.

## Remarques

> [!NOTE]
>
> L'ancienne version XINPUT 9.1.0 (incluse dans Windows Vista et versions ultérieures) renvoyait toujours un ensemble fixe de capacités, quel que soit l'appareil connecté.

Pour plus d'informations sur les capacités signalées, consultez [XINPUT\_CAPABILITIES](https://docs.xbox.com/fr/reference/input/xinputongameinput/structs/xinput_capabilities.md).

Pour plus d'informations, consultez [Le wrapper XInputOnGameInput](https://docs.xbox.com/fr/build/core-features/common/input/porting/input-porting-xinput.md#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 de XInput vers GameInput](https://docs.xbox.com/fr/build/core-features/common/input/porting/input-porting-xinput.md)\
[XInputOnGameInput](https://docs.xbox.com/fr/reference/input/xinputongameinput/xinputongameinput_members.md)


## Related topics

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