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

> IXtfInputClient::ConnectGamepad Method

# IXtfInputClient::ConnectGamepad Method

创建虚拟控制器，并获取其设备标识符。

## 语法

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

### 参数

*pControllerId*\
类型：UINT64 \*

指向 UINT64 的指针，用于接收此 [IXtfInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 的设备标识符。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

**ConnectGamepad** 为创建的每个虚拟控制器分配系统资源，并返回将用于通过 [IXtfInputClient::SendGamepadReport](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md) 向开发主机发送输入的虚拟控制器的标识符。你的代码在调用 **ConnectGamepad** 后应等待 2 秒再调用 [SendGamepadReport](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)，以确保主机已完成新控制器的注册并准备好接受输入。你的代码应始终将对 **ConnectGamepad** 的调用与对 [DisconnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-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) 一次性释放所有虚拟控制器资源。

## 要求

**头文件：** 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::DisconnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-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

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