Función BdaCreateFilterFactoryEx (bdasup.h)

Artículo
08/07/2023

La función BdaCreateFilterFactoryEx agrega el descriptor de filtro especificado como generador de filtros al dispositivo especificado y asocia el generador 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 anclaje 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 KSFILTERFACTORY para el generador de filtros recién creado.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

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 para 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:

Un minidriver BDA llama a BdaCreateFilterFactoryEx en lugar de a 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	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y sistemas operativos posteriores.
Plataforma de destino	Escritorio
Encabezado	bdasup.h (incluya Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL