Compartilhar via

Filtro AVI Mux

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture 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 Audio/Video Capture 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.]

O filtro AVI Mux aceita vários fluxos de entrada e os interloca no formato AVI. O filtro usa pinos de entrada separados para cada fluxo de entrada e um pino de saída para o fluxo AVI.

Aplicativos de captura ou criação de vídeo podem usar esse filtro para salvar arquivos em disco no formato AVI. O filtro normalmente está conectado ao filtro do Gravador de Arquivos, mas pode se conectar a qualquer filtro cujo pin de entrada dá suporte às interfaces IStream e IMemInputPin.

Etiqueta Valor
Interfaces de filtro IBaseFilter, IConfigAviMux, IConfigInterleaving, IMediaSeeking, IPersistMediaPropertyBag, ISpecifyPropertyPages
Tipos de mídia de pino de entrada Qualquer tipo principal que corresponda a um FOURCC de estilo antigo ou MEDIATYPE_AUXLine21Data. (Para obter mais informações, consulte classe FOURCCMap.)
  • Se o tipo principal for MEDIATYPE_Audio, o formato deverá ser FORMAT_WaveFormatEx.
  • Se o tipo principal for MEDIATYPE_Video, o formato deverá ser FORMAT_VideoInfo ou FORMAT_DvInfo.
  • Se o tipo principal for MEDIATYPE_Interleaved, o formato deverá ser FORMAT_DvInfo.
Interfaces de pin de entrada IAMStreamControl, IMemInputPin, IPin, IPropertyBag IQualityControl
Tipos de mídia de pino de saída MEDIATYPE_Stream, MEDIASUBTYPE_Avi
Interfaces de pino de saída IPin, IQualityControl
Filtrar CLSID CLSID_AviDest
CLSID da página de propriedades CLSID_AviMuxProptyPage, CLSID_AviMuxProptyPage1
Executável qcap.dll
de Mérito MERIT_DO_NOT_USE
de categoria de filtro de CLSID_LegacyAmFilterCategory

 

Observações

As observações a seguir descrevem vários aspectos da funcionalidade do filtro AVI Mux.

Pinos

Quando o filtro AVI Mux é criado, ele tem um pin de entrada. À medida que cada pino de entrada está conectado, o filtro cria um novo pino de entrada.

Propriedades do fluxo

Os pinos de entrada dão suporte à interface IPropertyBag para definir propriedades em fluxos individuais. Atualmente, a seguinte propriedade é definida:

Propriedade Descrição
nome O nome do fluxo. Esta propriedade é escrita como uma parte 'strn'.

 

Se o filtro estiver em execução ou pausado, o método IPropertyBag::Write retornará VFW_E_WRONG_STATE.

Taxas de quadros

Se o filtro upstream não especificar uma taxa de quadros no AvgTimePerFrame membro da estrutura deVIDEOINFOHEADER, o AVI Mux usará os carimbos de data/hora no primeiro quadro de vídeo. O formato de arquivo AVI não dá suporte a taxas de quadro variável.

Quadros descartados

O filtro AVI Mux calcula quadros descartados com base nos tempos de mídia de cada exemplo, se disponíveis, ou então os carimbos de data/hora da amostra. Ele grava uma entrada de índice de comprimento zero para cada quadro descartado.

IMediaSeeking

O filtro AVI Mux implementa a interface IMediaSeeking da seguinte maneira:

  • O métodoGetCurrentPositionretorna o progresso atual do multiplexing. Se você estiver transcodando um arquivo (mais lento do que em tempo real), esse valor será mais preciso do que o valor retornado pelo Gerenciador de Grafo de Filtro. Para obter mais informações, consulte a seção Comentários da página de referência GetCurrentPosition.
  • O método GetDuration consulta cada filtro upstream e retorna a duração do fluxo mais longo. Se algum desses filtros falhar na chamada GetDuration (ou não der suporte a IMediaSeeking), o AVI Mux retornará um código de falha e preencherá o parâmetro pDuration com a duração mais longa encontrada. No entanto, o valor de pDuration, nesse caso, não é necessariamente o comprimento do fluxo de entrada mais longo.
  • O AVI Mux não implementa os métodos GetStopPosition, GetPositions, GetAvailable, GetRate ou GetPreroll; nem implementa nenhum método Set* para busca.

Extensões de formato de arquivo do AVI 2.0

No momento, o DirectShow dá suporte às seguintes extensões de formato de arquivo AVI 2.0:

  • Aumento do tamanho do arquivo AVI (maior que 1 GB)
  • Indexação hierárquica

Para obter mais informações, consulte a versão 1.02 das "Extensões de Formato de Arquivo OpenDML AVI" publicadas pelo Subcomitê de Formato de Arquivo OpenDML AVI M-JPEG.

de Filtros do DirectShow