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

# DisconnectGamepad

> Método IXtfInputClient::DisconnectGamepad

# Método IXtfInputClient::DisconnectGamepad

Desconecta um controle virtual especificado.

## Sintaxe

```cpp theme={null}
public:
HRESULT DisconnectGamepad(
         UINT64 controllerId
)  
```

### Parâmetros

*controllerId*\
Tipo: UINT64

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

Chame **DisconnectGamepad** quando as operações do controle virtual forem concluídas, para garantir que os recursos alocados para o controle virtual sejam liberados. Cada chamada a [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) deve ser emparelhada com uma chamada a **DisconnectGamepad**. Não desconectar um gamepad criado resultará em um vazamento de memória. Você 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 garantir que todos os controles virtuais sejam desconectados a fim de evitar um vazamento de memória.

## 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::DisconnectAllGamepads](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [DisconnectAllGamepads](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [ConnectGamepad](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [Interface IXtfInputClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [GAMEPAD_VIBRATION](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfinput/structures/gamepad_vibration.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/pt-BR/reference/input/xinputongameinput/structs/xinput_gamepad.md)
