HidP_GetLinkCollectionNodes-Funktion (hidpi.h)

Artikel
02/29/2024

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
HIDP_STATUS_SUCCESS	Die Routine hat erfolgreich das Linksammlungsarray der angegebenen Auflistung zurückgegeben.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die vorbereiteten Daten sind ungültig.
HIDP_STATUS_BUFFER_TOO_SMALL	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

Weitere Informationen

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA

Freigeben über