HidP_UsageListDifference函数 (hidpi.h)

HidP_UsageListDifference 例程返回 HID 用法的两个数组之间的差异。

语法

NTSTATUS HidP_UsageListDifference(
  [in]  PUSAGE PreviousUsageList,
  [in]  PUSAGE CurrentUsageList,
  [out] PUSAGE BreakUsageList,
  [out] PUSAGE MakeUsageList,
  [in]  ULONG  UsageListLength
);

参数

[in] PreviousUsageList

指向例程与 CurrentUsageList中的使用情况列表的指针。

[in] CurrentUsageList

指向例程与 PreviousUsageList中的使用情况列表的指针。

[out] BreakUsageList

指向调用方分配的缓冲区的指针,返回时,该缓冲区包含 PreviousUsageList中的用法列表,但在 CurrentUsageList中不包含。

[out] MakeUsageList

指向调用方分配的缓冲区的指针,返回时,该缓冲区包含 CurrentUsageList中的用法列表,但在 PreviousUsageList中不包含。

[in] UsageListLength

指定在 CurrentUsageList 提供的缓冲区的长度(以数组元素为单位)和 PreviousUsageList

返回值

HidP_UsageListDifference 返回HIDP_STATUS_SUCCESS。

言论

用户模式应用程序或内核模式驱动程序可以使用此例程来比较两个使用情况列表,例如,确定两个 HidP_GetButtons 调用返回的两个使用列表之间的按钮状态更改。

如果输入使用情况列表具有不同的长度,则应用程序或驱动程序应将 UsageListLength 设置为较大列表的长度。

例程将输入使用情况列表中的零个用法解释为结束列表的分隔符。 列表中零后的任何用法都不会处理。 输出列表中的未使用的用法设置为零。

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

要求

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

另请参阅

HidP_UsageAndPageListDifference