funzione HidP_GetLinkCollectionNodes (hidpi.h)
La routine HidP_GetLinkCollectionNodes restituisce una matrice di raccolta di collegamentidi primo livello.
Sintassi
NTSTATUS HidP_GetLinkCollectionNodes(
[out] PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
[in, out] PULONG LinkCollectionNodesLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
Parametri
[out] LinkCollectionNodes
Puntatore a una matrice allocata dal chiamante di strutture HIDP_LINK_COLLECTION_NODE in cui HidP_GetLinkCollectionNodes restituisce una matrice di raccolta di collegamenti di primo livello.
[in, out] LinkCollectionNodesLength
Specifica, in base all'input, la lunghezza, negli elementi della matrice, del buffer LinkCollectionNodes . Nell'output, la routine imposta LinkCollectionNodesLength sul numero di voci nella matrice impostata.
[in] PreparsedData
Puntatore ai dati pronti della raccolta di livello superiore per cui questa routine restituisce una matrice di raccolta di collegamenti.
Valore restituito
HidP_GetLinkCollectionNodes restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
La routine ha restituito correttamente la matrice di raccolta dei collegamenti della raccolta specificata. |
|
I dati pronti non sono validi. |
|
Il buffer LinkCollectionNodes è troppo piccolo per contenere l'intera matrice di raccolte di collegamenti. |
Commenti
La lunghezza richiesta del buffer LinkCollectionNodes viene specificata dal membro NumberLinkCollectionNodes della struttura HIDP_CAPS di una raccolta.
Se HidP_GetLinkCollectionNodes restituisce il valore di stato HIDP_STATUS_BUFFER_TOO_SMALL, imposta anche LinkCollectionNodesLength sulla lunghezza, negli elementi della matrice, necessari per contenere le informazioni sui nodi della raccolta di collegamenti.
Per altre informazioni, vedere Raccolte HID.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | hidpi.h (include Hidpi.h) |
| Libreria | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |