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

Consulte también

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology