HidP_GetButtonCaps函数 (hidpi.h)
HidP_GetButtonCaps 例程返回一个 按钮功能数组,该数组描述指定类型 HID 报表 顶级集合中的所有 HID 控件按钮。
语法
NTSTATUS HidP_GetButtonCaps(
[in] HIDP_REPORT_TYPE ReportType,
[out] PHIDP_BUTTON_CAPS ButtonCaps,
[in, out] PUSHORT ButtonCapsLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
参数
[in] ReportType
指定标识报表类型的 HIDP_REPORT_TYPE 枚举器值。
[out] ButtonCaps
指向调用方分配的缓冲区的指针,该缓冲区的例程用于返回指定报表类型的按钮功能数组。
[in, out] ButtonCapsLength
指定在 ButtonCaps提供的缓冲区的输入长度(以数组元素为单位)。 输出时,此参数设置为例程返回的实际元素数。
[in] PreparsedData
指向顶级集合 预先分析的数据的指针。
返回值
HidP_GetButtonCaps 返回以下状态值之一:
返回代码 | 描述 |
---|---|
|
例程已成功返回功能数据。 |
|
预先分析的数据无效。 |
言论
HidP_GetButtonCaps 返回指定报表类型的顶级集合中所有按钮的功能。
ButtonCapsLength 应设置为由 HidP_GetCaps返回的 HIDP_CAPS 结构的 NumberXxxButtonCaps 成员的值,其中 Xxx 指定报表类型。
若要获取按钮功能的子集,请通过 使用情况、使用情况页或 链接集合选择,请使用 HidP_GetSpecificButtonCaps。
有关集合功能的详细信息,请参阅 获取集合信息。
另请参阅 HID 集合。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 普遍 |
标头 | hidpi.h (包括 Hidpi.h) |
库 | Hidparse.lib |
IRQL | PASSIVE_LEVEL |