Función BdaMethodCreateTopology (bdasup.h)

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 de la solicitud para crear topología. El minidriver BDA recibe este IRP con la solicitud KSMETHOD_BDA_CREATE_TOPOLOGY.

[in] pKSMethod

Apunta a una estructura de 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.

Observaciones

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 minidrives envíen directamente la función BdaMethodCreateTopology. 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 de 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.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	bdasup.h (incluya Bdasup.h)
biblioteca de	Bdasup.lib
irQL	PASSIVE_LEVEL

Consulte también

BdaCreateTopology

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_TOPOLOGY

KStrMethodHandler