跳转到主要内容
向设备发送原始功能报告。

语法

参数

report   _In_
类型:IGameInputRawDeviceReport*
要发送的功能报告。通过使用 GameInputRawFeatureReport 调用 CreateRawDeviceReport 来创建该报告,并通过调用 IGameInputRawDeviceReport::SetRawData 填充该报告。

返回值

类型:HRESULT 如果报告已提交到设备,则返回 S_OK。如果设备是聚合设备,则返回 GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED;如果无法提交报告,则返回其他错误代码。

备注

SetRawDeviceFeature 方法将功能报告写入设备。报告 ID 取自该报告的 GameInputRawDeviceReportInfo,有效负载是通过 IGameInputRawDeviceReport::SetRawData 设置的数据。 使用 GetFeatureReportCount 和 GetFeatureReportInfo 发现设备定义了哪些功能报告以及每个报告的大小。目前仅对 HID 设备公开功能报告。对于 HID 设备,报告数据的第一个字节是报告 ID。 SetRawDeviceFeature 会将报告排队等待传送,并在不等待设备处理的情况下返回。成功的返回值表示报告已提交,而不表示设备已接受该报告。若要确认新状态,请通过调用 GetRawDeviceFeature 读回该报告。
有关 GameInput API 的中级和高级用例,请参阅 GameInput 高级主题。

要求

头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

GameInput 概述
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

版本历史

附录:以前的版本

v0

在 GameInput v0 中,此方法以相同的签名声明,但未实现。有关详细信息,请参阅 IGameInputDevice::SetRawDeviceFeature(已弃用)。
最后修改于 2026年11月6日