通过

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

指定 属性 缓冲区的大小（必须大于或等于 sizeof（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、保留和 GlobalUnknowns），后跟 HIDP_UNKNOWN_TOKEN 结构的可变长度数组。 未知令牌数组的第一个成员位于（PHIDP_UNKNOWN_TOKEN*）&（属性->数据）。

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

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

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows 中可用。
目标平台 普遍
标头 hidpi.h （包括 Hidpi.h）
库 Hidparse.lib
IRQL <= DISPATCH_ LEVEL

另请参阅

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA