fonction HidP_GetLinkCollectionNodes (hidpi.h)
La routine HidP_GetLinkCollectionNodes retourne un tableau de collections de liens de niveau supérieur.
Syntaxe
NTSTATUS HidP_GetLinkCollectionNodes(
[out] PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
[in, out] PULONG LinkCollectionNodesLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
Paramètres
[out] LinkCollectionNodes
Pointeur vers un tableau alloué par l’appelant de structures HIDP_LINK_COLLECTION_NODE dans laquelle HidP_GetLinkCollectionNodes retourne le tableau de collection de liens d’une collection de niveau supérieur.
[in, out] LinkCollectionNodesLength
Spécifie, en entrée, la longueur, dans les éléments de tableau, du LinkCollectionNodes tampon. En sortie, la routine définit LinkCollectionNodesLength le nombre d’entrées dans le tableau qu’elle définit.
[in] PreparsedData
Pointeur vers les données préparées de la collection de niveau supérieur pour laquelle cette routine retourne un tableau de collection de liens.
Valeur de retour
HidP_GetLinkCollectionNodes retourne l’un des codes d’état suivants :
| Retourner le code | Description |
|---|---|
|
La routine a correctement retourné le tableau de collection de liens de la collection spécifiée. |
|
Les données prédéfinies ne sont pas valides. |
|
La mémoire tampon LinkCollectionNodes est trop petite pour contenir l’intégralité du tableau de collection de liens. |
Remarques
La longueur requise de la mémoire tampon LinkCollectionNodes est spécifiée par le membre numberLinkCollectionNodes de la structure HIDP_CAPS d’une collection.
Si HidP_GetLinkCollectionNodes retourne la valeur d’état HIDP_STATUS_BUFFER_TOO_SMALL, elle définit également LinkCollectionNodesLength sur la longueur, dans les éléments de tableau, requis pour contenir les informations des nœuds de collection de liens.
Pour plus d’informations, consultez collections HID.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | hidpi.h (include Hidpi.h) |
| bibliothèque | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |