funzione HidP_GetLinkCollectionNodes (hidpi.h)

Articolo
02/26/2024

La routine HidP_GetLinkCollectionNodes restituisce una matrice di raccolta di collegamenti di 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

Condividi tramite