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

# SendGamepadReportEx

> IXtfInputClient::SendGamepadReportEx

# IXtfInputClient::SendGamepadReportEx

將控制器狀態報告傳送至主機。

## 語法

```cpp theme={null}
HRESULT SendGamepadReportEx(  
         UINT64 controllerId,  
         GAMEPAD_REPORT_EX report  
)  
```

### 參數

*controllerId*   \
類型：UINT64

此 [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) 所傳回的控制器識別碼。

*report*   \
類型：[GAMEPAD\_REPORT\_EX](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)

要回報的控制器狀態。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

**SendGameReportEx** 方法會將以 [GAMEPAD\_REPORT\_EX](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md) 表示的控制器狀態，傳送至由 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) 建立的虛擬控制器。您需要傳送多個狀態，才能模擬單次按下並放開按鈕。若要模擬按下按鈕，請在 [GAMEPAD\_REPORT\_EX.Buttons](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md) 中設定適當的旗標並呼叫 **SendGamepadReportEx**，然後將 [GAMEPAD\_REPORT\_EX.Buttons](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md) 設定為 [GAMEPAD\_BUTTONS::NONE](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/enumerations/GAMEPAD_BUTTONS-typedef-xtfinput-xbox-windows-t.md) 並再次呼叫 **SendGamepadReportEx**。

**SendGamepadReportEx** 可以 60Hz 的頻率呼叫，以模擬來自實體控制器的資料。

## 需求

**標頭：** XtfInput.h

**程式庫：** xtfinput.lib

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

## 另請參閱

[XtfInput](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[GAMEPAD\_REPORT\_EX](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [GAMEPAD_REPORT_EX](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [IXtfInputClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)
- [SendGamepadReportWithAudio](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportwithaudio.md)
- [SendGamepadReport](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [GAMEPAD_REPORT 結構](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)