HidP_UsageListDifference-Funktion (hidpi.h)

  • Artikel

Die HidP_UsageListDifference Routine gibt die Unterschiede zwischen zwei Arrays von HID-Verwendungen zurück.

Syntax

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

Parameter

[in] PreviousUsageList

Zeiger auf eine Liste der Verwendungen, die die Routine mit der Liste der Verwendungen in CurrentUsageList vergleicht.

[in] CurrentUsageList

Zeiger auf eine Liste der Verwendungen, die die Routine mit der Liste der Verwendungen in PreviousUsageList vergleicht.

[out] BreakUsageList

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der bei der Rückgabe eine Liste der Verwendungen enthält, die sich in PreviousUsageList, aber nicht in CurrentUsageList befinden.

[out] MakeUsageList

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der bei der Rückgabe eine Liste der Verwendungen enthält, die sich in CurrentUsageList, aber nicht in PreviousUsageList befinden.

[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.

Hinweise

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 werden auf 0 (null) festgelegt.

Weitere Informationen finden Sie unter HID-Auflistungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header hidpi.h (hidpi.h einschließen)
Bibliothek Hidparse.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

HidP_UsageAndPageListDifference