HidP_GetValueCaps函数 (hidpi.h)

HidP_GetValueCaps例程返回值功能数组,该数组描述指定类型的 HID 报表的顶级集合中的所有 HID 控件值。

语法

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

参数

[in] ReportType

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

[out] ValueCaps

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

[in, out] ValueCapsLength

指定 ValueCaps 缓冲区在输入时在数组元素中的长度。 在输出时,例程将 ValueCapsLength 设置为它实际返回的元素数。

[in] PreparsedData

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

返回值

HidP_GetValueCaps 返回以下状态值之一:

返回代码 说明
HIDP_STATUS_SUCCESS
例程已成功返回功能数据。
HIDP_STATUS_INVALID_PREPARSED_DATA
预先分析的数据无效。

注解

ValueCapsLength 的正确长度由顶级集合HIDP_CAPS结构的NumberXxxValueCaps 成员指定。

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

另请参阅 HID 集合

要求

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

另请参阅

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA