Introdução às classes base de filtro
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Este artigo descreve a biblioteca de classes base do Microsoft DirectShow. Essa biblioteca destina-se a desenvolvedores de filtros, mas os gravadores de aplicativos podem achar algumas das classes auxiliares e utilitários de depuração úteis. No entanto, a biblioteca de classes base não é necessária para a programação do DirectShow.
As seções a seguir resumem as classes base mais importantes da biblioteca.
Classes de objeto COM
As seguintes classes dão suporte à criação de objetos COM:
| Classe | Descrição |
|---|---|
| Cbaseobject | Classe de objeto base. |
| Cunknown | Implementa a interface IUnknown . |
A maioria das classes DirectShow derivam de CBaseObject. Essa classe fornece assistência de depuração mantendo uma contagem de todos os objetos ativos na DLL em tempo de execução. Em builds de depuração, a DLL declara se ela é descarregada enquanto a contagem de objetos é maior que zero. Isso facilita o rastreamento de vazamentos causados por problemas de contagem de referência.
Todas as classes base que dão suporte a interfaces COM derivam de CUnknown, que herda CBaseObject. A classe CUnknown dá suporte à contagem de referência, QueryInterface e aggregration. Para obter mais informações, confira Como implementar o IUnknown.
Filtrar e fixar classes
As seguintes classes dão suporte à criação de objetos de filtro e fixação do DirectShow:
| Classe | Descrição |
|---|---|
| Cbasefilter | Classe base para filtros. Implementa a interface IBaseFilter . |
| Cbasepin | Classe base para pinos. Implementa as interfaces IPin e IQualityControl . |
| Cbaseinputpin | Classe base para pinos de entrada que usam o transporte de memória local. Implementa a interface IMemInputPin . Essa classe deriva de CBasePin. |
| Cbaseoutputpin | Classe base para pinos de saída que usam conexões IMemInputPin . Essa classe deriva de CBasePin. |
As seguintes classes são úteis para criar tipos mais especializados de filtros:
| Classe | Descrição |
|---|---|
| Csource | Classe base para filtros de origem. Essa classe foi projetada para criar fontes de push. Ele não é adequado para fontes de pull, como leitores de arquivos. Para criar pinos de saída para essa classe, use a classe CSourceStream . |
| Ctransformfilter | Classe base para filtros de transformação. Essa classe executa uma cópia nos dados. Os pinos dessa classe são CTransformInputPin e CTransformOutputPin. |
| Ctransinplacefilter | Classe base para filtros de transformação que não copiam dados. Essa classe executa o processamento de dados diretamente nos dados de entrada antes de passá-los downstream. Os pinos dessa classe são CTransInPlaceInputPin e CTransInPlaceOutputPin. |
| Cvideotransformfilter | Classe base para filtros de transformação de vídeo. Essa classe deriva de CTransformFilter e adiciona suporte para controle de qualidade. |
| Cbaserenderer | Classe base para filtros de renderizador. O pino de entrada para essa classe é CRendererInputPin. |
| Cbasevideorenderer | Classe base para renderizadores de vídeo. Essa classe deriva de CBaseRenderer. |
Para usar essas classes, você deve derivar sua própria classe e escrever código para dar suporte à funcionalidade específica do filtro. Quanto mais especializada for a classe base, menos código você precisará escrever em sua classe derivada.
Objetos auxiliares
As classes a seguir implementam objetos auxiliares usados por filtros e pinos. A maioria dessas classes pode ser usada sem derivar novas classes delas:
| Classe | Descrição |
|---|---|
| Cpullpin | Objeto auxiliar para pinos de entrada em filtros de analisador. Dá suporte a conexões IAsyncReader com fontes de pull. |
| Coutputqueue | Objeto auxiliar para pinos de saída que enfileiram amostras para entrega em um thread de trabalho. |
| Csourceseeking | Objeto de ajuda para implementar a busca em um filtro de origem com exatamente um pino de saída. (Essa classe não foi projetada para filtros com vários pinos, como analisadores.) |
| Cenumpins | Objeto enumerador para enumerar pinos em um filtro. Implementa a interface IEnumPins . |
| CEnumMediaTypes | Objeto enumerador para enumerar tipos de mídia preferenciais em um pin. Implementa a interface IEnumMediaTypes . |
| Cmemallocator | Objeto alocador de memória. Implementa a interface IMemAllocator . |
| Cmediasample | Objeto de exemplo de mídia. Implementa a interface IMediaSample2 . |
| Cbasereferenceclock | Classe base para relógios de referência. Implementa a interface IReferenceClock . |
| Cmediatype | Objeto auxiliar para manipular estruturas de AM_MEDIA_TYPE . |