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:
Código devuelto | Descripción |
---|---|
|
La rutina devolvió correctamente la matriz de colecciones de vínculos de la colección especificada. |
|
Los datos preparados no son válidos. |
|
El búfer LinkCollectionNodes es demasiado pequeño para contener toda la matriz de colecciones de vínculos. |
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
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de Windows. |
Plataforma de destino | Universal |
Encabezado | hidpi.h (incluya Hidpi.h) |
Library | Hidparse.lib |
IRQL | <= DISPATCH_LEVEL |