Función BdaMethodCreateTopology (bdasup.h)

Artículo
05/23/2024

La función BdaMethodCreateTopology crea una topología de plantilla entre dos patillas de un filtro.

Sintaxis

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

Parámetros

[in] pIrp

Apunta al IRP para que la solicitud cree una topología. El minidriver BDA recibe este IRP con la solicitud de KSMETHOD_BDA_CREATE_TOPOLOGY .

[in] pKSMethod

Apunta a una estructura KSMETHOD que describe el método y el tipo de solicitud de una solicitud de método.

[optional] pvIgnored

Apunta a un búfer que se omite.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

Un minidriver BDA llama a la función BdaMethodCreateTopology para crear la topología de plantilla entre dos patillas de filtro después de que el minidriver reciba una solicitud KSMETHOD_BDA_CREATE_TOPOLOGY del método KSMETHODSETID_BdaDeviceConfiguration establecido desde el proveedor de red. La mayoría de los minidrives BDA pueden definir tablas de distribución y automatización de filtros para que esos minidrivers envíen la función BdaMethodCreateTopology directamente. Algunos minidrivers de BDA deben interceptar esta solicitud, usando un método interno (KStrMethodHandler), en lugar de enviarlo directamente. Estos minidrivers deben obtener un puntero al filtro BDA del IRP pasado antes de llamar a BdaMethodCreateTopology para que puedan usar el filtro para realizar un seguimiento de las patillas asociadas. Estos minidrivers pueden enviar instrucciones al hardware al conectar determinados tipos de patillas. Consulte Definición de tablas de automatización y Configuración de un filtro BDA para obtener más información.

Si un minidriver BDA debe crear la topología de plantilla entre dos patillas de filtro sin depender del proveedor de red, el minidriver BDA debe llamar a la función BdaCreateTopology .