> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCreateInputClient

> XtfCreateInputClient

# XtfCreateInputClient

使用指定的地址初始化 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 接口的新实例。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
HRESULT XtfCreateInputClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

<a id="ID4EK" />

<a id="parametersSection" />

### 参数

*pszAddress*<br />类型：LPCWSTR

指向要用于新 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 实例的开发主机的工具 IP 地址的指针。

*riid*<br />类型：REFIID

接收新创建的 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 实例的实例标识符的指针。

*ppvObject*<br />类型：void \*\*

接收对新创建的 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 实例的引用的指针。

<a id="ID4ER" />

<a id="retvalSection" />

### 返回值

类型：HRESULT

操作的结果。

<a id="remarksSection" />

## 备注

使用此函数创建的 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 实例可创建、断开开发主机上的虚拟控制器以及向其发送游戏报告。你可以通过以编程方式模拟游戏手柄输入来自动执行单元测试、压力测试、长时间测试和用户测试。

有关详细信息，请参阅[模拟游戏手柄输入 (NDA 主题)](/build/console-features/debugging-diagnostics/xtf-gamepad-input-testing)。

<a id="requirements" />

<a id="requirementsSection" />

## 要求

**头文件：** xtfinput.h

**库：** xtfinput.lib

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

<a id="seealsoSection" />

## 另请参阅

[IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t)<br />[XtfInput](/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n)


## Related topics

- [XtfCreateApplicationClient](/zh-CN/reference/tools/xtf/xtfapplication/methods/xtfcreateapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XtfCreateUserClient](/zh-CN/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m.md)
- [XtfCreateFileIOClient](/zh-CN/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfInputClient::ConnectGamepad Method](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [IXtfInputClient::DisconnectGamepad Method](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)