HidP_GetUsagesEx-Funktion (hidpi.h)

Die HidP_GetUsagesEx Routine gibt eine Liste aller HID-Steuerelementschaltflächen Verwendungen zurück, die in einem HID-Bericht auf EIN festgelegt sind.

Syntax

NTSTATUS HidP_GetUsagesEx(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USHORT               LinkCollection,
  [in, out] PUSAGE_AND_PAGE      ButtonList,
  [in, out] ULONG                *UsageLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

Parameter

[in] ReportType

Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Berichtstyp identifiziert.

[in] LinkCollection

Gibt die Linkauflistung der Schaltflächenverwendungen an. Wenn LinkCollection- ungleich Null ist, gibt die Routine nur Informationen zu den Schaltflächen zurück, die diese Linkauflistung enthält; andernfalls, wenn LinkCollection null ist, gibt die Routine Informationen zu allen Schaltflächen in der Auflistung der obersten Ebene zugeordnet PreparsedData-zurück.

[in, out] ButtonList

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der zum Zurückgeben der Verwendungs- und Verwendungsseite verwendet wird, Bezeichner für jede Schaltfläche, die auf EIN (1) festgelegt ist.

[in, out] UsageLength

Gibt für Eingaben die Länge des ButtonList- Puffers in Arrayelementen an. Gibt für die Ausgabe die Anzahl der Verwendungen an, die derzeit im angegebenen Bericht auf "EIN" festgelegt sind.

[in] PreparsedData

Zeiger auf die vordefinierten Daten einer Auflistung auf oberster Ebene.

[in] Report

Zeigen Sie auf einen Bericht, der Schaltflächendaten enthält.

[in] ReportLength

Gibt die Länge des Berichts in Bytes an, der sich in Reportbefindet.

Rückgabewert

HidP_GetUsagesEx gibt einen der folgenden Statuswerte zurück:

Bemerkungen

Benutzermodusanwendungen und Kernelmodustreiber rufen HidP_MaxUsageListLength auf, um die maximale Anzahl von Schaltflächen zu bestimmen, die für den angegebenen Berichtstyp zurückgegeben werden. Alternativ können Anwendungen oder Treiber HidP_GetUsagesEx aufrufen und (*UsageLength) auf Null festlegen, um die erforderliche Länge in UsageLength-zurückzugeben. Mit anderen Worten, UsageLength- sollte ein gültiger Zeiger sein, der auf einen ULONG-Wert 0 zeigt, um die erforderliche Länge abzurufen.

Anwendungen oder Treiber bestimmen die erforderliche Berichtslänge aus der XxxReportByteLength Member in der HIDP_CAPS-Struktur einer Obersten Ebene.

Weitere Informationen finden Sie unter HID Collections.

Anforderungen

Siehe auch

• HidP_GetButtons
• HidP_GetButtonsEx
• HidP_GetCaps
• HidP_GetScaledUsageValue
• HidP_GetUsageValue
• HidP_GetUsageValueArray
• HidP_GetUsagesEx
• HidP_MaxUsageListLength
• USAGE_AND_PAGE
• _HIDP_PREPARSED_DATA