Función BdaInitFilter (bdasup.h)
La función BdaInitFilter inicializa el contexto de filtro de BDA asociado a una instancia de filtro.
Sintaxis
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
Parámetros
[in] pKSFilter
Apunta al filtro en el que se va a inicializar el contexto de filtro de BDA.
[in] pBdaFilterTemplate
Apunta a una estructura de BDA_FILTER_TEMPLATE que describe la plantilla de filtro para el dispositivo BDA. Para determinar la topología para y configurar el filtro inicializado, el proveedor de red usa información a la que se hace referencia en esta estructura de BDA_FILTER_TEMPLATE.
Valor devuelto
Devuelve STATUS_SUCCESS o un código de error adecuado.
Comentarios
Un minidriver BDA llama a la función BdaInitFilter para inicializar una instancia de un filtro mediante una plantilla de filtro BDA específica y un generador de filtros que se creó anteriormente a través de una llamada a la función BdaCreateFilterFactory . Posteriormente, el minidriver BDA puede usar esta instancia de filtro en llamadas a otras funciones de compatibilidad de BDA, como BdaCreatePin.
Cuando un minidriver BDA llama a BdaInitFilter, el controlador de compatibilidad BDA (Bdasup.sys) crea su propio contexto de filtro BDA. Este contexto de filtro BDA está oculto en el minidriver de BDA. Sin embargo, cuando sea necesario, el controlador de compatibilidad de BDA puede acceder a este contexto de filtro de BDA. El controlador de compatibilidad con BDA agrega un puntero a este contexto de filtro de BDA al contenedor de objetos para el objeto KSFILTER asociado. Cuando se destruye el objeto KSFILTER asociado, AVStream solicita que el controlador de soporte técnico de BDA elimine este contexto de filtro de BDA del contenedor de objetos. De este modo, el controlador de soporte de BDA puede destruir este contexto de filtro BDA sin necesidad de intervención del minidriver BDA.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y en sistemas operativos posteriores. Esta rutina está disponible en la plataforma Windows 2000 solo si Microsoft DirectX 9.0 y versiones posteriores está instalado en esa plataforma. |
| Plataforma de destino | Escritorio |
| Encabezado | bdasup.h (incluya Bdasup.h) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |