Share via

функция 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