Función BdaCreateFilterFactoryEx (bdasup.h)

Artículo
02/06/2025

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

Sintaxis

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

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.

[out, optional] ppKSFilterFactory

Apunta a un búfer que recibe un puntero a una estructura de KSFILTERFACTORY para el generador de filtros recién creado.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Observaciones

Un minidriver BDA llama a la función BdaCreateFilterFactoryEx 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 a métodos y propiedades:

Un minidriver BDA llama a BdaCreateFilterFactoryEx en lugar de la función BdaCreateFilterFactory siempre que requiera un puntero al KSFILTERFACTORY recién creado. La función BdaCreateFilterFactory también crea un generador de filtros, pero no lo devuelve al autor de la llamada. El minidriver BDA requiere un puntero al KSFILTERFACTORY recién creado si el minidriver debe llamar a la función _KsEdit para editar KSFILTERFACTORY.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Microsoft Windows XP y sistemas operativos posteriores.
de la plataforma de destino de	Escritorio
encabezado de	bdasup.h (incluya Bdasup.h)
biblioteca de	Bdasup.lib
irQL	PASSIVE_LEVEL