função HidP_GetLinkCollectionNodes (hidpi.h)

  • Artigo

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
HIDP_STATUS_SUCCESS
 A rotina retornou com êxito a matriz de coleção de links da coleção especificada.
HIDP_STATUS_INVALID_PREPARSED_DATA
 Os dados pré-preparados não são válidos.
HIDP_STATUS_BUFFER_TOO_SMALL
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

Confira também

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA