Condividi tramite


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
HIDP_STATUS_SUCCESS
La routine ha restituito correttamente la matrice di raccolta dei collegamenti della raccolta specificata.
HIDP_STATUS_INVALID_PREPARSED_DATA
I dati pronti non sono validi.
HIDP_STATUS_BUFFER_TOO_SMALL
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

Vedi anche

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA