HidP_UsageListDifference-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_UsageListDifference Routine gibt die Unterschiede zwischen zwei Arrays HID-Verwendungenzurück.

Syntax

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

Parameter

[in] PreviousUsageList

Zeigen Sie auf eine Liste der Verwendungen, die die Routine mit der Liste der Verwendungen in CurrentUsageListvergleicht.

[in] CurrentUsageList

Zeigen Sie auf eine Liste der Verwendungen, die die Routine mit der Liste der Verwendungen in PreviousUsageListvergleicht.

[out] BreakUsageList

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der im Gegenzug eine Liste der Verwendungen enthält, die sich in PreviousUsageListbefinden, jedoch nicht in CurrentUsageList-.

[out] MakeUsageList

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der im Gegenzug eine Liste der Verwendungen enthält, die sich in CurrentUsageList-befinden, jedoch nicht in PreviousUsageList.

[in] UsageListLength

Gibt die Länge der Puffer in Arrayelementen an, die unter CurrentUsageList und PreviousUsageList-bereitgestellt werden.

Rückgabewert

HidP_UsageListDifference gibt HIDP_STATUS_SUCCESS zurück.

Bemerkungen

Eine Benutzermodusanwendung oder ein Kernelmodustreiber kann diese Routine verwenden, um zwei Verwendungslisten zu vergleichen, z. B. um die Änderung des Schaltflächenzustands zwischen zwei Verwendungslisten zu bestimmen, die von zwei HidP_GetButtons Aufrufen zurückgegeben werden.

Wenn die Eingabeverwendungslisten unterschiedliche Längen aufweisen, sollte eine Anwendung oder ein Treiber UsageListLength- auf die Länge der größeren Liste festlegen.

Die Routine interpretiert eine Nullverwendung in einer Eingabeverwendungsliste als Trennzeichen, das die Liste beendet. Alle Verwendungen nach einer Null in einer Liste werden nicht verarbeitet. Nicht verwendete Verwendungen in einer Ausgabeliste sind auf Null festgelegt.

Weitere Informationen finden Sie unter HID Collections.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	hidpi.h (include Hidpi.h)
Library	Hidparse.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

HidP_UsageAndPageListDifference

Freigeben über