HidP_GetExtendedAttributes-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_GetExtendedAttributes Routine gibt die erweiterten Attribute eines HID-Steuerelements zurück.

Syntax

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

Parameter

[in] ReportType

Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Typ des HID-Berichts angibt, der dem hiD-Steuerelement zugeordnet ist, das durch DataIndex-angegeben wird.

[in] DataIndex

Gibt den Datenindex des HID-Steuerelements an.

[in] PreparsedData

Gibt die vordefinierten Daten an, die für die Auflistung auf oberster Ebene, die das angegebene Steuerelement enthält,.

[out] Attributes

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, den die Routine verwendet, um die erweiterten Attribute des Steuerelements zurückzugeben, das durch DataIndex-angegeben wird.

[in, out] LengthAttributes

Gibt die Größe des Attributes- Puffers in Bytes an (die größer oder gleich Sizeof(HIDP_EXTENDED_ATTRIBUTES) sein muss.

Rückgabewert

HidP_GetExtendedAttributes gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Die Routine hat erfolgreich alle erweiterten Attributinformationen des Steuerelements zurückgegeben.
HIDP_STATUS_BUFFER_TOO_SMALL	Der Attribut- Puffer war nicht groß genug, um alle erweiterten Attributinformationen zu enthalten.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	Der angegebene Datenindex ist ungültig.

Bemerkungen

HidP_GetExtendedAttributes gibt eine variable Länge HIDP_EXTENDED_ATTRIBUTES Struktur im Attribut- Puffer zurück. Die struktur der erweiterten Attribute enthält in aufeinander folgender Reihenfolge die Elemente mit fester Länge (NumGlobalUnknowns, Reservedund GlobalUnknowns) gefolgt von einem Array mit variabler Länge von HIDP_UNKNOWN_TOKEN Strukturen. Das erste Mitglied des unbekannten Tokenarrays befindet sich in (PHIDP_UNKNOWN_TOKEN*)&(Attributes->Data).

Die Routine gibt so viele Bytes der erweiterten Attributinformationen zurück, wie der Attribut Puffer enthalten kann. Wenn der Puffer zu klein ist, schneidet die Routine die zurückgegebenen Informationen ab. Um die Anzahl unbekannter Token im Array mit variabler Länge zu ermitteln, kann ein Aufrufer zunächst den Attributes Puffer verwenden, um den Wert der NumGlobalUnknowns Member der erweiterten Attributinformationen zurückzugeben.

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-	<= DISPATCH_ EBENE

Siehe auch

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Freigeben über