HidP_GetExtendedAttributes 函数 (hidpi.h)

  • 项目

HidP_GetExtendedAttributes例程返回 HID 控件的扩展属性。

语法

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

参数

[in] ReportType

指定 HIDP_REPORT_TYPE 枚举器值，该值指示与 DataIndex 指定的 HID 控件关联的 HID 报表的类型。

[in] DataIndex

指定 HID 控件 的数据索引 。

[in] PreparsedData

指定包含指定控件的顶级集合的预分析数据。

[out] Attributes

指向调用方分配的缓冲区的指针，例程使用该缓冲区返回 DataIndex 指定的控件的扩展属性。

[in, out] LengthAttributes

指定 属性 缓冲区 (的大小（以字节为单位），该缓冲区必须大于或等于 size of (HIDP_EXTENDED_ATTRIBUTES) 。

返回值

HidP_GetExtendedAttributes 返回以下状态值之一：

返回代码 说明
HIDP_STATUS_SUCCESS
 例程已成功返回控件的所有扩展属性信息。
HIDP_STATUS_BUFFER_TOO_SMALL
 属性缓冲区不够大，无法保存所有扩展属性信息。
HIDP_STATUS_DATA_INDEX_NOT_FOUND
 指定的数据索引无效。

注解

HidP_GetExtendedAttributes在属性缓冲区中返回一个可变长度HIDP_EXTENDED_ATTRIBUTES结构。 扩展属性结构连续包含固定长度成员 (NumGlobalUnknowns、 Reserved 和 GlobalUnknowns) 后跟 HIDP_UNKNOWN_TOKEN 结构的可变长度数组。 未知令牌数组的第一个成员位于 (PHIDP_UNKNOWN_TOKEN*) & (Attributes-Data>) 。

例程返回与 属性 缓冲区可以容纳的扩展属性信息一样多的字节数。 如果缓冲区太小，例程将截断它返回的信息。 若要确定可变长度数组中的未知标记数，调用方可以首先使用 Attributes 缓冲区返回扩展属性信息的 NumGlobalUnknowns 成员的值。

有关详细信息，请参阅 HID 集合。

要求

要求 值
最低受支持的客户端 在 Windows 2000 和更高版本的 Windows 中可用。
目标平台 通用
标头 hidpi.h (包括 Hidpi.h)
Library Hidparse.lib
IRQL <= DISPATCH_ LEVEL

另请参阅

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA