HidP_GetLinkCollectionNodes-Funktion (hidpi.h)
Die HidP_GetLinkCollectionNodes Routine gibt das Linksammlungsarray einer Auflistung der obersten Ebene zurück.
Syntax
NTSTATUS HidP_GetLinkCollectionNodes(
[out] PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
[in, out] PULONG LinkCollectionNodesLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
Parameter
[out] LinkCollectionNodes
Zeiger auf ein vom Aufrufer zugeordnetes Array von HIDP_LINK_COLLECTION_NODE Strukturen, in denen HidP_GetLinkCollectionNodes das Linksammlungsarray einer Auflistung der obersten Ebene zurückgibt.
[in, out] LinkCollectionNodesLength
Gibt bei der Eingabe die Länge des LinkCollectionNodes-Puffers in Arrayelementen an. Bei der Ausgabe legt die Routine LinkCollectionNodesLength auf die Anzahl der Einträge im array fest, das sie festgelegt hat.
[in] PreparsedData
Zeiger auf die vorbereiteten Daten der Auflistung der obersten Ebene, für die diese Routine ein Linksammlungsarray zurückgibt.
Rückgabewert
HidP_GetLinkCollectionNodes gibt einen der folgenden status Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Routine hat erfolgreich das Linksammlungsarray der angegebenen Auflistung zurückgegeben. |
|
Die vorbereiteten Daten sind ungültig. |
|
Der LinkCollectionNodes-Puffer ist zu klein, um das gesamte Linksammlungsarray aufzunehmen. |
Hinweise
Die erforderliche Länge des LinkCollectionNodes-Puffers wird vom NumberLinkCollectionNodes-Element der HIDP_CAPS-Struktur einer Auflistung angegeben.
Wenn HidP_GetLinkCollectionNodes den status-Wert HIDP_STATUS_BUFFER_TOO_SMALL zurückgibt, wird auch LinkCollectionNodesLength auf die Länge festgelegt, die in Arrayelementen erforderlich ist, um die Informationen der Linksammlungsknoten zu speichern.
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 | <= DISPATCH_LEVEL |