跳轉到主要內容
從裝置讀取原始功能報告。

語法

參數

reportId   _In_
類型:uint32_t
要讀取之功能報告的識別碼。必須符合 GetFeatureReportInfo 所傳回其中一個報告的 id 成員。 report   _COM_Outptr_
類型:IGameInputRawDeviceReport**
接收新的 IGameInputRawDeviceReport 物件,其中包含從裝置讀取的功能報告資料。失敗時設定為 nullptr。

傳回值

類型:HRESULT 成功時傳回 S_OK。如果裝置未定義具有指定識別碼的功能報告,則傳回 E_NOTFOUND;如果裝置是彙總裝置,則傳回 GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED。如果無法從裝置讀取報告,則傳回其他錯誤碼。

備註

GetRawDeviceFeature 方法會向裝置要求功能報告的目前內容,並在新的 IGameInputRawDeviceReport 物件中傳回這些內容。報告之 GameInputRawDeviceReportInfo 的 kind 成員為 GameInputRawFeatureReport,且其資料大小符合 GetFeatureReportInfo 所傳回之對應元素的 size 成員。呼叫 GetRawDataSize 和 IGameInputRawDeviceReport::GetRawData 以讀取資料。 使用 GetFeatureReportCount 和 GetFeatureReportInfo 找出裝置定義了哪些功能報告。目前會針對 HID 裝置公開功能報告。對於 HID 裝置,報告資料的第一個位元組是報告識別碼。 與其他原始報告方法不同,GetRawDeviceFeature 會等待裝置回覆後才傳回,因此請避免在時間關鍵的執行緒 (例如您的轉譯或輸入輪詢執行緒) 上呼叫此方法。
如需 GameInput API 的中階和進階使用案例,請參閱 GameInput 進階主題。

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 概觀
SetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
IGameInputRawDeviceReport
CreateRawDeviceReport
IGameInputDevice

版本歷程記錄

附錄:先前版本

v0

在 GameInput v0 中,此方法以相同的簽章宣告,但並未實作。如需詳細資訊,請參閱 IGameInputDevice::GetRawDeviceFeature (已淘汰)。
最後修改於 2026年11月6日