HidP_GetSpecificValueCaps函数（hidpi.h）

项目
02/07/2025

HidP_GetSpecificValueCaps 例程返回一个值功能数组，该数组描述满足指定选择条件的所有 HID 控件值。

语法

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

参数

[in] ReportType

指定标识报表类型的 HIDP_REPORT_TYPE 枚举器值。

[in] UsagePage

将使用情况页指定为搜索条件。如果 UsagePage 为非零，则仅返回指定此使用情况页的值。

[in] LinkCollection

将链接集合指定为搜索条件。如果 LinkCollection 为非零，则仅返回此链接集合中的值。

[in] Usage

指定 HID 用法作为搜索条件。如果 使用情况 为非零，则仅返回指定此用法的值。

[out] ValueCaps

指向调用方分配的缓冲区的指针，在该缓冲区中，例程返回指定报表类型的值功能数组。

[in, out] ValueCapsLength

指定在 ValueCaps提供的缓冲区的输入的长度（以数组元素为单位）。在输出中，此参数设置为例程实际返回的元素数。

[in] PreparsedData

指向顶级集合的预分析数据的指针。

返回值

HidP_GetSpecificValueCaps 返回以下状态值之一：

返回代码	NT 状态值	描述
HIDP_STATUS_SUCCESS	0x00110000	例程已成功返回功能数据。
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	预先分析的数据无效。
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	指定报表类型的任何报表中不存在此用法。

言论

ValueCaps 缓冲区的所需大小由顶级集合 HIDP_CAPS 结构的 NumberXxxValueCaps 成员指定。

调用 HidP_GetSpecificValueCaps时，为 usagePage、Usage指定零，LinkCollection 等效于调用 HidP_GetValueCaps。

有关集合功能的详细信息，请参阅获取集合信息。

另请参阅 HID 集合。

要求

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