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