función HidP_GetLinkCollectionNodes (hidpi.h)

La rutina HidP_GetLinkCollectionNodes devuelve una matriz de colecciones de vínculos de nivel superior.

Sintaxis

NTSTATUS HidP_GetLinkCollectionNodes(
  [out]     PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
  [in, out] PULONG                     LinkCollectionNodesLength,
  [in]      PHIDP_PREPARSED_DATA       PreparsedData
);

Parámetros

[out] LinkCollectionNodes

Puntero a una matriz asignada por el autor de la llamada de HIDP_LINK_COLLECTION_NODE estructuras en las que HidP_GetLinkCollectionNodes devuelve una matriz de colecciones de vínculos de nivel superior.

[in, out] LinkCollectionNodesLength

Especifica, en la entrada, la longitud, en los elementos de matriz, del búfer LinkCollectionNodes . En la salida, la rutina establece LinkCollectionNodesLength en el número de entradas de la matriz que estableció.

[in] PreparsedData

Puntero a los datos preparados de la colección de nivel superior para la que esta rutina devuelve una matriz de recopilación de vínculos.

Valor devuelto

HidP_GetLinkCollectionNodes devuelve uno de los siguientes códigos de estado:

Comentarios

La longitud necesaria del búfer LinkCollectionNodes se especifica mediante el miembro NumberLinkCollectionNodes de la estructura HIDP_CAPS de una colección.

Si HidP_GetLinkCollectionNodes devuelve el valor de estado HIDP_STATUS_BUFFER_TOO_SMALL, también establece LinkCollectionNodesLength en la longitud, en los elementos de matriz, necesarios para contener la información de los nodos de la colección de vínculos.

Para obtener más información, consulte Colecciones HID.

Requisitos

Consulte también

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA