HidP_InitializeReportForID函式 (hiDPI.h)

HidP_InitializeReportForID常式會初始化 HID 報告。

語法

NTSTATUS HidP_InitializeReportForID(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  UCHAR                ReportID,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [out] PCHAR                Report,
  [in]  ULONG                ReportLength
);

參數

[in] ReportType

指定 HIDP_REPORT_TYPE 列舉值,指出位於 報表的 HID 報表類型。

[in] ReportID

指定報表識別碼。

[in] PreparsedData

與位於報表之 HID 報表相關聯之最上層集合之預先剖析資料的指標。

[out] Report

呼叫端配置的緩衝區指標,其中包含 HidP_InitializeReportForID 初始化的 HID 報表。

[in] ReportLength

指定位於 [報表] 之 HID 報表的大小,以位元組為單位。 ReportLength必須等於集合所指定報表類型的報表長度,如集合HIDP_CAPS結構的XxxReportByteLength成員所指定。

傳回值

HidP_InitializeReportForID 會傳回下列其中一個狀態值:

傳回碼 描述
HIDP_STATUS_SUCCESS
已成功初始化報表。
HIDP_STATUS_INVALID_PREPARSED_DATA
預先剖析的資料無效。
HIDP_STATUS_INVALID_REPORT_LENGTH
報表的指定長度不等於指定之報表類型的集合報表長度。
HIDP_STATUS_INVALID_REPORT_TYPE
報表類型無效。
HIDP_STATUS_REPORT_DOES_NOT_EXIST
指定的報表識別碼無效。

備註

初始化 HID 報表會將所有控制項資料設定為零或控制項的 Null 值,如 USB HID 標準所定義。 (傳送或接收 null 值表示控制項的目前值不應修改。)

HidP_InitializeReportForID 會執行下列動作:

  • 將所有按鈕和值不含 Null 值的位欄位設定為零。
  • 將所有具有 Null 值的控制項位欄位設定為其對應的 Null 值。
如需詳細資訊,請參閱 HID 集合

必要條件

   
最低支援的用戶端 適用于 Windows 2000 和更新版本的 Windows。
目標平臺 環球
標頭 hiDPI.h (包含 HiDPI.h)
程式庫 Hidparse.lib
IRQL <= DISPATCH_LEVEL

另請參閱

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA