> ## 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étodo IXtfInputClient::ConnectGamepad

# Método IXtfInputClient::ConnectGamepad

Cria um controle virtual e obtém o identificador de dispositivo dele.

## Sintaxe

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

### Parâmetros

*pControllerId*\
Tipo: UINT64 \*

Ponteiro para um UINT64 que recebe o identificador de dispositivo deste [IXtfInputClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md).

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT.

## Comentários

**ConnectGamepad** aloca recursos do sistema para cada controle virtual criado, além de retornar o identificador do controle virtual que será usado para enviar entrada a um console de desenvolvimento com [IXtfInputClient::SendGamepadReport](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md). Seu código deve aguardar 2 segundos após chamar **ConnectGamepad** antes de chamar [SendGamepadReport](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md), para garantir que o console tenha concluído o registro do novo controle e esteja pronto para aceitar entrada. Seu código deve sempre emparelhar uma chamada a **ConnectGamepad** com uma chamada a [DisconnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) para garantir que esses recursos do sistema sejam liberados para reutilização. Você também pode chamar [IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) para liberar todos os recursos de controles virtuais de uma só vez.

## Requisitos

**Cabeçalho:** xtfinput.h

**Biblioteca:** xtfinput.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

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


## Related topics

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