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

> IXtfInputClient::ConnectGamepad (método)

# IXtfInputClient::ConnectGamepad (método)

Crea un mando virtual y obtiene su identificador de dispositivo.

## Sintaxis

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

### Parámetros

*pControllerId*\
Tipo: UINT64 \*

Puntero a un UINT64 que recibe el identificador de dispositivo de este [IXtfInputClient](https://docs.xbox.com/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md).

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

**ConnectGamepad** asigna recursos del sistema para cada mando virtual creado y devuelve el identificador del mando virtual que se usará para enviar entradas a una consola de desarrollo con [IXtfInputClient::SendGamepadReport](https://docs.xbox.com/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md). El código debe esperar 2 segundos después de llamar a **ConnectGamepad** antes de llamar a [SendGamepadReport](https://docs.xbox.com/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md), para garantizar que la consola haya terminado de registrar el nuevo mando y esté lista para aceptar entradas. El código siempre debe emparejar una llamada a **ConnectGamepad** con una llamada a [DisconnectGamepad](https://docs.xbox.com/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) para garantizar que estos recursos del sistema se liberen para su reutilización. También puede llamar a [IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) para liberar todos los recursos de mandos virtuales a la vez.

## Requisitos

**Encabezado:** xtfinput.h

**Biblioteca:** xtfinput.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

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


## Related topics

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