Función BdaPropertyNodeDescriptors (bdasup.h)
La función BdaPropertyNodeDescriptors recupera una lista de nodos de una topología de plantilla.
Sintaxis
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
Parámetros
[in] pIrp
Apunta al IRP de la solicitud para recuperar la lista de nodos. El minidriver BDA recibe este IRP con la solicitud de KSPROPERTY_BDA_NODE_DESCRIPTORS .
[in] pKSProperty
Apunta a una estructura KSPROPERTY que describe la propiedad y el tipo de solicitud de la solicitud de propiedad.
[out, optional] pNodeDescriptorProperty
Apunta a una matriz que recibe la lista de GUID para los nodos de una topología de plantilla.
Valor devuelto
Devuelve STATUS_SUCCESS o un código de error adecuado.
Comentarios
Un minidriver BDA llama a la función BdaPropertyNodeDescriptors para recuperar la lista de nodos después de que el minidriver reciba una solicitud KSPROPERTY_BDA_NODE_DESCRIPTORS de la propiedad KSPROPSETID_BdaTopology establecida desde el proveedor de red. La mayoría de los minidrivers BDA pueden definir tablas de distribución y automatización de filtros para que esos minidrivers envíen directamente la función BdaPropertyNodeDescriptors , sin interceptar esta solicitud mediante un controlador get interno (KStrGetPropertyHandler). Consulte Definición de tablas de automatización y determinación de la topología de dispositivos BDA para obtener más información.
Para obtener una lista de los nodos de BDA que están disponibles para crear en una topología de plantilla, consulte GUID de categoría de nodo de BDA.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y sistemas operativos posteriores. Esta rutina está disponible en la plataforma Windows 2000 solo si Microsoft DirectX 9.0 y versiones posteriores está instalado en esa plataforma. |
| Plataforma de destino | Escritorio |
| Encabezado | bdasup.h (incluya Bdasup.h) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |