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

# IXtfInputClient::ConnectGamepad (método)

> IXtfInputClient::ConnectGamepad (método)

# IXtfInputClient::ConnectGamepad (método)

Crea un mando virtual y obtiene su identificador de dispositivo.

<a id="syntaxSection" />

## Sintaxis

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

<a id="ID4EG" />

### Parámetros

*pControllerId*\
Tipo: UINT64 \*

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

<a id="ID4EP" />

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

<a id="remarks" />

## 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](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m). El código debe esperar 2 segundos después de llamar a **ConnectGamepad** antes de llamar a [SendGamepadReport](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m), 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](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m) para garantizar que estos recursos del sistema se liberen para su reutilización. También puede llamar a [IXtfInputClient::DisconnectAllGamepads](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m) para liberar todos los recursos de mandos virtuales a la vez.

<a id="requirements" />

## Requisitos

**Encabezado:** xtfinput.h

**Biblioteca:** xtfinput.lib

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

## Consulte también

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


## Related topics

- [IXtfInputClient::DisconnectGamepad (método)](/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::DisconnectAllGamepads (método)](/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::SendGamepadReport (método)](/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::SendGamepadReportEx](/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [IXtfInputClient::SendGamepadReportWithAudio](/es/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)