Función BdaInitFilter (bdasup.h)
La función BdaInitFilter inicializa el contexto de filtro 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 de 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.
Observaciones
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 de BDA (Bdasup.sys) crea su propio contexto de filtro BDA. Este contexto de filtro BDA está oculto en el minidriver BDA. Sin embargo, cuando sea necesario, el controlador de compatibilidad con BDA puede acceder a este contexto de filtro de BDA. El controlador de compatibilidad con BDA agrega un puntero a este contexto de filtro BDA al contenedor de objetos del objeto KSFILTER asociado objeto. Cuando se destruye el objeto KSFILTER asociado, AVStream solicita que el controlador de soporte técnico de BDA elimine este contexto de filtro 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y 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. |
| de la plataforma de destino de | Escritorio |
| encabezado de | bdasup.h (incluya Bdasup.h) |
| biblioteca de | Bdasup.lib |
| irQL | PASSIVE_LEVEL |