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

> IXtfInputClient::DisconnectGamepad Method

# IXtfInputClient::DisconnectGamepad Method

断开指定的虚拟控制器。

## 语法

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

### 参数

*controllerId*\
类型：UINT64

此 [IXtfInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 的设备标识符。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

虚拟控制器操作完成后调用 **DisconnectGamepad**，以确保为虚拟控制器分配的资源被释放。每次对 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) 的调用都应与对 **DisconnectGamepad** 的调用配对。如果未能断开已创建的游戏手柄，将导致内存泄漏。你可以调用 [IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) 以确保所有虚拟控制器都被断开，从而避免内存泄漏。

## 要求

**头文件：** xtfinput.h

**库：** xtfinput.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [DisconnectAllGamepads](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [ConnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [GAMEPAD_VIBRATION](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/structures/gamepad_vibration.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/zh-CN/reference/input/xinputongameinput/structs/xinput_gamepad.md)