通过

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

指定报表 ID。

[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
 指定的报表 ID 无效。

言论

初始化 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