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

# IXtfInputClient::DisconnectGamepad 方法

中斷指定虛擬控制器的連線。

## 語法

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

### 參數

*controllerId*\
類型：UINT64

此 [IXtfInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 的裝置識別碼。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

在虛擬控制器作業完成時呼叫 **DisconnectGamepad**，以確保為虛擬控制器配置的資源會釋放。每次呼叫 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) 都應與 **DisconnectGamepad** 呼叫配對。若未中斷已建立之遊戲控制器的連線，將會導致記憶體流失。您可以呼叫 [IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/zh-TW/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-TW/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[IXtfInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [DisconnectAllGamepads](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [ConnectGamepad](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [GAMEPAD_VIBRATION](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_vibration.md)
- [XINPUT_GAMEPAD](https://docs.xbox.com/zh-TW/reference/input/xinputongameinput/structs/xinput_gamepad.md)