HidP_GetExtendedAttributes-Funktion (hidpi.h)
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 Enumeratorwert an, der den Typ des HID-Berichts angibt, der dem durch DataIndex angegebenen HID-Steuerelement zugeordnet ist.
[in] DataIndex
Gibt den Datenindex des HID-Steuerelements an.
[in] PreparsedData
Gibt die vorab vorbereiteten Daten für die Auflistung der obersten Ebene an , die das angegebene Steuerelement enthält.
[out] Attributes
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, den die Routine verwendet, um die erweiterten Attribute des von DataIndex angegebenen Steuerelements zurückzugeben.
[in, out] LengthAttributes
Gibt die Größe des Attributes-Puffers (in Bytes) an (der größer oder gleich sizeof(HIDP_EXTENDED_ATTRIBUTES sein muss).
Rückgabewert
HidP_GetExtendedAttributes gibt einen der folgenden status Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Routine hat erfolgreich alle erweiterten Attributinformationen des Steuerelements zurückgegeben. |
|
Der Attributpuffer war nicht groß genug, um alle erweiterten Attributinformationen aufzunehmen. |
|
Der angegebene Datenindex ist ungültig. |
Hinweise
HidP_GetExtendedAttributes gibt eine variable Länge HIDP_EXTENDED_ATTRIBUTES Struktur im Attributpuffer zurück. Die Struktur der erweiterten Attribute enthält in aufeinanderfolgender Reihenfolge die Elemente mit fester Länge (NumGlobalUnknowns, Reserved und GlobalUnknowns), gefolgt von einem Array mit variabler Länge aus HIDP_UNKNOWN_TOKEN Strukturen. Das erste Element des unbekannten Tokenarrays befindet sich unter (PHIDP_UNKNOWN_TOKEN*)&(Attributes-Data>).
Die Routine gibt so viele Bytes der erweiterten Attributinformationen zurück, wie der Attributpuffer 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 bestimmen, kann ein Aufrufer zunächst den Puffer Attribute verwenden, um den Wert des NumGlobalUnknowns-Members der Informationen zu erweiterten Attributen zurückzugeben.
Weitere Informationen finden Sie unter HID-Sammlungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Universell |
| Header | hidpi.h (einschließlich Hidpi.h) |
| Bibliothek | Hidparse.lib |
| IRQL | <= DISPATCH_ EBENE |