Función BdaCreateFilterFactory (bdasup.h)

Artículo
08/07/2023

La función BdaCreateFilterFactory agrega el descriptor de filtro especificado como generador de filtros al dispositivo especificado y asocia el generador de filtros con la topología de plantilla BDA especificada.

Sintaxis

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Parámetros

[in] pKSDevice

Apunta al dispositivo BDA al que se va a agregar el generador de filtros con la topología de plantilla de BDA asociada.

[in] pFilterDescriptor

Apunta a una estructura de KSFILTER_DESCRIPTOR que describe un filtro para el dispositivo BDA. Tenga en cuenta que no todos los tipos de pin y nodo de plantilla se pueden exponer como generadores de patillas y nodos cuando el filtro se inicializa por primera vez.

[in] pBdaFilterTemplate

Apunta a una estructura de BDA_FILTER_TEMPLATE que describe una topología de plantilla de BDA.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

Un minidriver BDA llama a la función BdaCreateFilterFactory para agregar un generador de filtros con una topología de plantilla de BDA asociada a un dispositivo y registrar todas las estructuras de plantilla estáticas de la topología con la biblioteca de compatibilidad de BDA (BdaSup.sys). A continuación, la biblioteca de compatibilidad de BDA puede controlar las siguientes llamadas de método y propiedad:

Si un minidriver BDA requiere un puntero al generador de filtros recién creado (KSFILTERFACTORY), el minidriver debe llamar a la función BdaCreateFilterFactoryEx en su lugar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y en sistemas operativos posteriores.
Plataforma de destino	Escritorio
Encabezado	bdasup.h (incluya Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL