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

# XtfCreateInputClient

> XtfCreateInputClient

# XtfCreateInputClient

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

## 语法

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

### 参数

*pszAddress*\
类型：LPCWSTR

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

*riid*\
类型：REFIID

接收新创建的 [IXtfInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 实例的实例标识符的指针。

*ppvObject*\
类型：void \*\*

接收对新创建的 [IXtfInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 实例的引用的指针。

### 返回值

类型：HRESULT

操作的结果。

## 备注

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

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

## 要求

**头文件：** xtfinput.h

**库：** xtfinput.lib

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

## 另请参阅

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


## Related topics

- [IXtfInputClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [XtfInput（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)
- [XtfCreateFileIOClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfCreateApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/methods/xtfcreateapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XtfCreateUserClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m.md)