función HidP_GetLinkCollectionNodes (hidpi.h)
La rutina HidP_GetLinkCollectionNodes devuelve una matriz de colecciones de vínculosde 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 LinkCollectionNodes búfer. En la salida, la rutina establece LinkCollectionNodesLength al 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 LinkCollectionNodes búfer es demasiado pequeño para contener toda la matriz de colecciones de vínculos. |
Observaciones
La longitud necesaria del búfer LinkCollectionNodes se especifica mediante el NumberLinkCollectionNodes miembro 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 a la longitud, en los elementos de matriz, necesarios para contener la información de los nodos de colección de vínculos.
Para obtener más información, consulte colecciones HID.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | hidpi.h (incluya Hidpi.h) |
| biblioteca de | Hidparse.lib |
| irQL | <= DISPATCH_LEVEL |