Introducción a las clases base de filtro

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

En este artículo se describe la biblioteca de clases base Microsoft DirectShow. Esta biblioteca está pensada para desarrolladores de filtros, pero los escritores de aplicaciones pueden encontrar algunas de las clases auxiliares y utilidades de depuración útiles. Sin embargo, la biblioteca de clases base no es necesaria para la programación directShow.

En las secciones siguientes se resumen las clases base más importantes de la biblioteca.

Clases de objeto COM

Las clases siguientes admiten la creación de objetos COM:

Clase	Descripción
CBaseObject	Clase de objeto base.
CUnknown	Implementa la interfaz IUnknown .

 

La mayoría de las clases DirectShow derivan de CBaseObject. Esta clase proporciona asistencia para depurar manteniendo un recuento de todos los objetos activos en el archivo DLL en tiempo de ejecución. En las compilaciones de depuración, el archivo DLL afirma si se descarga mientras el recuento de objetos es mayor que cero. Esto facilita el seguimiento de pérdidas causadas por problemas de recuento de referencias.

Todas las clases base que admiten interfaces COM derivan de CUnknown, que hereda CBaseObject. La clase CUnknown admite recuento de referencias, QueryInterface y aggregración. Para obtener más información, vea Cómo implementar IUnknown.

Filtrar y anclar clases

Las siguientes clases admiten la creación de objetos de filtro y anclaje de DirectShow:

Clase	Descripción
CBaseFilter	Clase base para filtros. Implementa la interfaz IBaseFilter .
CBasePin	Clase base para patillas. Implementa las interfaces IPin e IQualityControl .
CBaseInputPin	Clase base para patillas de entrada que usan el transporte de memoria local. Implementa la interfaz IMemInputPin . Esta clase deriva de CBasePin.
CBaseOutputPin	Clase base para patillas de salida que usan conexiones IMemInputPin . Esta clase deriva de CBasePin.

 

Las siguientes clases son útiles para crear tipos de filtros más especializados:

Clase	Descripción
CSource	Clase base para filtros de origen. Esta clase está diseñada para crear orígenes de inserción. No es adecuado para orígenes de extracción, como lectores de archivos. Para crear patillas de salida para esta clase, use la clase CSourceStream .
CTransformFilter	Clase base para filtros de transformación. Esta clase realiza una copia en los datos. Los patillas de esta clase son CTransformInputPin y CTransformOutputPin.
CTransInPlaceFilter	Clase base para filtros de transformación que no copian datos. Esta clase realiza el procesamiento de datos directamente en los datos de entrada antes de pasarlos de bajada. Los patillas de esta clase son CTransInPlaceInputPin y CTransInPlaceOutputPin.
CVideoTransformFilter	Clase base para filtros de transformación de vídeo. Esta clase se deriva de CTransformFilter y agrega compatibilidad con el control de calidad.
CBaseRenderer	Clase base para filtros de representador. El pin de entrada de esta clase es CRendererInputPin.
CBaseVideoRenderer	Clase base para representadores de vídeo. Esta clase deriva de CBaseRenderer.

 

Para usar estas clases, debe derivar su propia clase y escribir código para admitir la funcionalidad específica del filtro. Cuanto más especializado sea la clase base, menos código tendrá que escribir en la clase derivada.

Objetos auxiliares

Las clases siguientes implementan objetos auxiliares que se usan en filtros y patillas. La mayoría de estas clases se pueden usar sin derivar nuevas clases de ellas:

Clase	Descripción
CPullPin	Objeto auxiliar para patillas de entrada en filtros del analizador. Admite conexiones IAsyncReader con orígenes de extracción.
COutputQueue	Objeto auxiliar para patillas de salida que ponen en cola ejemplos para la entrega en un subproceso de trabajo.
CSourceSeeking	Objeto de ayuda para implementar la búsqueda en un filtro de origen con exactamente un pin de salida. (Esta clase no está diseñada para filtros con varios pines, como analizadores).
CEnumPins	Objeto enumerador para enumerar patillas en un filtro. Implementa la interfaz IEnumPins .
CEnumMediaTypes	Objeto enumerador para enumerar los tipos de medios preferidos en un pin. Implementa la interfaz IEnumMediaTypes .
CMemAllocator	Objeto de asignador de memoria. Implementa la interfaz IMemAllocator .
CMediaSample	Objeto de ejemplo multimedia. Implementa la interfaz IMediaSample2 .
CBaseReferenceClock	Clase base para relojes de referencia. Implementa la interfaz IReferenceClock .
CMediaType	Objeto auxiliar para manipular estructuras de AM_MEDIA_TYPE .