Función BdaCreateFilterFactoryEx (bdasup.h)
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 |