функция HidP_UsageListDifference (hidpi.h)

Статья
02/07/2025

Подпрограмма 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 (include Hidpi.h)
библиотеки	Hidparse.lib
IRQL	PASSIVE_LEVEL

См. также

HidP_UsageAndPageListDifference

Поделиться через