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

Consulte también

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER