跳轉到主要內容
將原始功能報告傳送至裝置。

語法

參數

report   _In_
類型:IGameInputRawDeviceReport*
要傳送的功能報告。請以 GameInputRawFeatureReport 呼叫 CreateRawDeviceReport 來建立報告,並呼叫 IGameInputRawDeviceReport::SetRawData 加以填入。

傳回值

類型:HRESULT 如果報告已提交至裝置,則傳回 S_OK。如果裝置是彙總裝置,則傳回 GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED;如果無法提交報告,則傳回其他錯誤碼。

備註

SetRawDeviceFeature 方法會將功能報告寫入裝置。報告識別碼取自報告的 GameInputRawDeviceReportInfo,而承載則是使用 IGameInputRawDeviceReport::SetRawData 設定的資料。 使用 GetFeatureReportCount 和 GetFeatureReportInfo 找出裝置定義了哪些功能報告,以及每個功能報告的大小。目前會針對 HID 裝置公開功能報告。對於 HID 裝置,報告資料的第一個位元組是報告識別碼。 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日