> ## 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.

# ConnectGamepad

> Méthode IXtfInputClient::ConnectGamepad

# Méthode IXtfInputClient::ConnectGamepad

Crée une manette virtuelle et obtient son identificateur d'appareil.

## Syntaxe

```cpp theme={null}
public:
HRESULT ConnectGamepad(
         UINT64 *pControllerId
)  
```

### Paramètres

*pControllerId*\
Type : UINT64 \*

Pointeur vers un UINT64 qui reçoit l'identificateur d'appareil de cet objet [IXtfInputClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md).

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

**ConnectGamepad** alloue des ressources système pour chaque manette virtuelle créée et retourne l'identificateur de la manette virtuelle qui sera utilisé pour envoyer des entrées à une console de développement avec [IXtfInputClient::SendGamepadReport](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md). Votre code doit attendre 2 secondes après l'appel de **ConnectGamepad** avant d'appeler [SendGamepadReport](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md), afin de s'assurer que la console a terminé l'inscription de la nouvelle manette et est prête à accepter des entrées. Votre code doit toujours associer un appel à **ConnectGamepad** à un appel à [DisconnectGamepad](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) pour garantir que ces ressources système sont libérées en vue de leur réutilisation. Vous pouvez également appeler [IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) pour libérer toutes les ressources des manettes virtuelles en une seule fois.

## Configuration requise

**En-tête :** xtfinput.h

**Bibliothèque :** xtfinput.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[XtfInput](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[IXtfInputClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::DisconnectGamepad](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [GAMEPAD_REPORT_EX](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [Structure GAMEPAD_REPORT](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [DisconnectGamepad](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [SendGamepadReport](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [DisconnectAllGamepads](https://docs.xbox.com/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)