> ## 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-TW/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-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 執行個體之開發主機工具 IP 位址的指標。

*riid*\
類型：REFIID

接收新建立之 [IXtfInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 執行個體之執行個體識別碼的指標。

*ppvObject*\
類型：void \*\*

接收新建立之 [IXtfInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 執行個體參考的指標。

### 傳回值

類型：HRESULT

作業的結果。

## 備註

使用此函式所建立的 [IXtfInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 執行個體，在開發主機上建立虛擬控制器、中斷其連線，以及將遊戲報告傳送至虛擬控制器。您可以透過程式設計方式模擬遊戲控制器輸入，將單元測試、壓力測試、長時間測試和使用者測試自動化。

如需詳細資訊，請參閱[模擬遊戲控制器輸入 (NDA 主題)](https://docs.xbox.com/zh-TW/build/console-features/debugging-diagnostics/xtf-gamepad-input-testing.md)。

## 需求

**標頭：** xtfinput.h

**程式庫：** xtfinput.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

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


## Related topics

- [IXtfInputClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [XtfInput (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)
- [XtfCreateApplicationClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/methods/xtfcreateapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XtfCreateFileIOClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfCreateUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m.md)