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 de 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.
Observaciones
Un minidriver BDA llama a los 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 de BDA pueden definir tablas de distribución y automatización de filtros para que esos minidrivers envíen los BdaPropertyNodeDescriptors función directamente, sin interceptar esta solicitud mediante un controlador get interno (KStrGetPropertyHandler). Consulte Definición de tablas de automatización y determinar la topología de dispositivos BDA para obtener más información.
Para obtener una lista de nodos BDA que están disponibles para crear en una topología de plantilla, consulte GUID de categoría de nodo de BDA.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| de la plataforma de destino de | Escritorio |
| encabezado de | bdasup.h (incluya Bdasup.h) |
| biblioteca de | Bdasup.lib |
| irQL | PASSIVE_LEVEL |