função HidP_GetLinkCollectionNodes (hidpi.h)
A rotina HidP_GetLinkCollectionNodes retorna a matriz de coleção de links de uma coleção de nível superior.
Sintaxe
NTSTATUS HidP_GetLinkCollectionNodes(
[out] PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
[in, out] PULONG LinkCollectionNodesLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
Parâmetros
[out] LinkCollectionNodes
Ponteiro para uma matriz alocada pelo chamador de estruturas de HIDP_LINK_COLLECTION_NODE em que HidP_GetLinkCollectionNodes retorna a matriz de coleção de links de uma coleção de nível superior.
[in, out] LinkCollectionNodesLength
Especifica, na entrada, o comprimento, em elementos de matriz, do buffer LinkCollectionNodes . Na saída, a rotina define LinkCollectionNodesLength como o número de entradas na matriz que ela definiu.
[in] PreparsedData
Ponteiro para os dados pré-preparados da coleção de nível superior para a qual essa rotina retorna uma matriz de coleção de links.
Retornar valor
HidP_GetLinkCollectionNodes retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
|
A rotina retornou com êxito a matriz de coleção de links da coleção especificada. |
|
Os dados pré-preparados não são válidos. |
|
O buffer LinkCollectionNodes é muito pequeno para conter toda a matriz de coleção de links. |
Comentários
O comprimento necessário do buffer LinkCollectionNodes é especificado pelo membro NumberLinkCollectionNodes da estrutura HIDP_CAPS de uma coleção.
Se HidP_GetLinkCollectionNodes retornar o valor status HIDP_STATUS_BUFFER_TOO_SMALL, ele também definirá LinkCollectionNodesLength como o comprimento, em elementos de matriz, necessário para manter as informações dos nós da coleção de links.
Para obter mais informações, consulte Coleções HID.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | hidpi.h (inclua Hidpi.h) |
| Biblioteca | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |