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

# SendGamepadReportWithAudio

> IXtfInputClient::SendGamepadReportWithAudio

# IXtfInputClient::SendGamepadReportWithAudio

向主机发送控制器状态报告。

## 语法

```cpp theme={null}
HRESULT SendGamepadReportWithAudio(  
         UINT64 controllerId,  
         GAMEPAD_REPORT_EX report,  
         INT32 audioType,  
         SAFEARRAY* audioData  
)  
```

### 参数

*controllerId*   \
类型：UINT64

此 [IXtfInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) 的设备标识符。\
该控制器 ID 是 [IXtfInputClient::ConnectGamepad](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) 返回的控制器 ID。

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

要报告的控制器状态。

*audioType*   \
类型：INT32

待定

*audioData*   \
类型：SAFEARRAY\*

待定

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 要求

**头文件：** XtfInput.h

**库：** xtfinput.lib

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

## 另请参阅

[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)
- [SendGamepadReport](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [SendGamepadReportEx](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)
- [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)