Función BdaPropertyTemplateConnections (bdasup.h)

Artículo
08/07/2023

La función BdaPropertyTemplateConnections recupera una lista de conexiones que describen cómo se conectan los tipos de patillas y los tipos de nodo en una topología de plantilla.

Sintaxis

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Parámetros

[in] pIrp

Apunta al IRP de la solicitud para recuperar la lista de conexiones. El minidriver BDA recibe este IRP con la solicitud KSPROPERTY_BDA_TEMPLATE_CONNECTIONS .

[in] pKSProperty

Apunta a una estructura KSPROPERTY que describe la propiedad y el tipo de solicitud de la solicitud de propiedad.

[out, optional] pConnectionProperty

Apunta a una matriz que recibe la lista de estructuras de KSTOPOLOGY_CONNECTION que describen las conexiones 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 BdaPropertyTemplateConnections para recuperar la lista de conexiones de plantilla después de que el minidriver reciba una solicitud KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 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 la función BdaPropertyTemplateConnections directamente, 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.

El minidriver BDA proporcionó una lista de conexiones a la biblioteca de compatibilidad de BDA en una matriz de estructuras de KSTOPOLOGY_CONNECTION cuando el minidriver BDA pasó la plantilla de filtro BDA (BDA_FILTER_TEMPLATE) en las llamadas de función BdaCreateFilterFactory y BdaInitFilter . Esta matriz es una representación de todas las posibles conexiones entre los tipos de nodo y patilla que se pueden realizar dentro del filtro o entre los filtros de filtro y adyacentes. La función BdaPropertyTemplateConnections devuelve esta matriz.