語法
參數
infoArrayCount _In_類型:uint32_t infoArray 中的元素數目。若要擷取所有功能報告,請傳遞 GetFeatureReportCount 傳回的值。 infoArray _Out_writes_to_opt_(infoArrayCount, return)
類型:GameInputRawDeviceReportInfo* 指向陣列的指標,此陣列會針對每個功能報告接收一個結構。可以是
nullptr,在此情況下不會寫入任何內容,且方法會傳回 0。
傳回值
類型:uint32_t 寫入 infoArray 的元素數目。此值為 infoArrayCount 與裝置上功能報告數目兩者中的較小值;如果 infoArray 為nullptr 或裝置沒有功能報告,則為 0。
備註
每個元素都是一個 GameInputRawDeviceReportInfo 結構,其kind 成員為 GameInputRawFeatureReport,id 成員為裝置定義的報告識別碼,size 成員則為報告資料的大小 (以位元組為單位)。
呼叫 GetFeatureReportCount 以取得功能報告數目,配置該大小的陣列,然後呼叫 GetFeatureReportInfo 加以填入。如果 infoArrayCount 小於功能報告數目,則只會寫入前 infoArrayCount 個元素。在裝置連線期間,裝置的功能報告不會變更,因此您可以只查詢一次並快取結果。
將元素的 id 成員當作 GetRawDeviceFeature 的 reportId 參數以讀取報告,或將其與 GameInputRawFeatureReport 一起當作 CreateRawDeviceReport 的 reportId 參數,以建立可透過 SetRawDeviceFeature 傳送的報告。size 成員提供報告資料的位元組數目。
下列範例示範如何擷取裝置的功能報告。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀GetFeatureReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
GetRawDeviceFeature
SetRawDeviceFeature
CreateRawDeviceReport
GameInput 進階主題
IGameInputDevice
