HidP_UnsetUsages函数（hidpi.h）

项目
02/07/2025

HidP_UnsetUsages 例程设置指定的 HID 控制按钮 HID 报表中 OFF （零）的用法。

语法

NTSTATUS HidP_UnsetUsages(
  [in]           HIDP_REPORT_TYPE     ReportType,
  [in]           USAGE                UsagePage,
  [in, optional] USHORT               LinkCollection,
  [in, out]      PUSAGE               UsageList,
  [in, out]      PULONG               UsageLength,
  [in]           PHIDP_PREPARSED_DATA PreparsedData,
  [in]           PCHAR                Report,
  [in]           ULONG                ReportLength
);

参数

[in] ReportType

指定一个 HIDP_REPORT_TYPE 枚举器值，该值指示位于报表的报表的类型。

[in] UsagePage

指定由 UsageList指定的使用情况的使用情况页。

[in, optional] LinkCollection

指定包含用法的链接集合。如果 LinkCollection 为非零，则例程仅设置此链接集合中的用法（如果存在）。如果 LinkCollection 为零，则例程将设置它在与 PreparsedData关联的顶级集合中查找的每个用法的第一个用法。

[in, out] UsageList

指向要设置为 OFF 的用法数组的指针。

[in, out] UsageLength

指定在输入时，UsageList中的使用情况数。有关输出值的信息，请参阅“备注”部分。

[in] PreparsedData

指向与位于报表报表关联的顶级集合预先分析的数据的指针。

[in] Report

指向报表的指针。

[in] ReportLength

指定位于报表报表处的报表的大小（以字节为单位），该大小必须与 HidP_GetCaps 集合 HIDP_CAPS 结构中返回的指定报表类型的报表长度相等。

返回值

如果 HidP_UnsetUsages 成功设置为 OFF UsageList中的所有用法，HidP_UnsetUsages 将返回HIDP_STATUS_SUCCESS。

如果其中一个输入参数无效，HidP_UnsetUsages 返回以下状态值之一：

返回代码	描述
HIDP_STATUS_INVALID_PREPARSED_DATA	PreparsedData 指定的预分析数据无效。
HIDP_STATUS_INVALID_REPORT_LENGTH	报表长度无效。
HIDP_STATUS_INVALID_REPORT_TYPE	报表类型无效。
HIDP_STATUS_REPORT_DOES_NOT_EXIST	该集合不包含指定类型的报表。

如果 HidP_UnsetUsages 无法设置为 UsageList中的某个用法，则返回以下状态值之一：

返回代码	描述
HIDP_STATUS_BUTTON_NOT_PRESSED	用法已设置为 OFF。
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	用法不包含在指定的报表中，但包含在指定类型的另一个报表中。
HIDP_STATUS_USAGE_NOT_FOUND	例程未在任何指定类型的报表中找到用法。

言论

HidP_UnsetUsages 设置 usageLength ，如下所示：

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

要求

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