AVI Mux Filter
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The AVI Mux filter accepts multiple input streams and interleaves them into AVI format. The filter uses separate input pins for each input stream, and one output pin for the AVI stream.
Video capture or authoring applications can use this filter to save files to disk in AVI format. The filter is typically connected to the File Writer filter, but it can connect to any filter whose input pin supports the IStream and IMemInputPin interfaces.
| Label | Value |
|---|---|
| Filter Interfaces | IBaseFilter, IConfigAviMux, IConfigInterleaving, IMediaSeeking, IPersistMediaPropertyBag, ISpecifyPropertyPages |
| Input Pin Media Types | Any major type that corresponds to an old-style FOURCC, or MEDIATYPE_AUXLine21Data. (For more information, see FOURCCMap Class.)
|
| Input Pin Interfaces | IAMStreamControl, IMemInputPin, IPin, IPropertyBag, IQualityControl |
| Output Pin Media Types | MEDIATYPE_Stream, MEDIASUBTYPE_Avi |
| Output Pin Interfaces | IPin, IQualityControl |
| Filter CLSID | CLSID_AviDest |
| Property Page CLSID | CLSID_AviMuxProptyPage, CLSID_AviMuxProptyPage1 |
| Executable | qcap.dll |
| Merit | MERIT_DO_NOT_USE |
| Filter Category | CLSID_LegacyAmFilterCategory |
Remarks
The following remarks describe various aspects of the AVI Mux filter's functionality.
Pins
When the AVI Mux filter is created, it has one input pin. As each input pin is connected, the filter creates a new input pin.
Stream Properties
The input pins support the IPropertyBag interface for setting properties on individual streams. Currently, the following property is defined:
| Property | Description |
|---|---|
| name | The name of the stream. This property is written as a 'strn' chunk. |
If the filter is running or paused, the IPropertyBag::Write method returns VFW_E_WRONG_STATE.
Frame Rates
If the upstream filter does not specify a frame rate in the AvgTimePerFrame member of the VIDEOINFOHEADER structure, the AVI Mux uses the time stamps on the first video frame. The AVI file format does not support variable frame rates.
Dropped Frames
The AVI Mux filter calculates dropped frames based on each sample's media times, if available, or else the sample's time stamps. It writes a zero-length index entry for every dropped frame.
IMediaSeeking
The AVI Mux filter implements the IMediaSeeking interface as follows:
- The GetCurrentPosition method returns the current progress of the multiplexing. If you are transcoding a file (slower than real time), this value is more accurate than the value returned by the Filter Graph Manager. For more information, see the Remarks section of the GetCurrentPosition reference page.
- The GetDuration method queries each upstream filter and returns the duration of the longest stream. If any of these filters fails the GetDuration call (or does not support IMediaSeeking), the AVI Mux returns a failure code and fills in the pDuration parameter with the longest duration found. However, the value of pDuration in this case is not necessarily the length of the longest input stream.
- The AVI Mux does not implement the GetStopPosition, GetPositions, GetAvailable, GetRate, or GetPreroll methods; nor does it implement any Set* methods for seeking.
AVI 2.0 File Format Extensions
DirectShow currently supports the following AVI 2.0 file format extensions:
- Increased AVI file size (greater than 1 GB)
- Hierarchical indexing
For more information, see version 1.02 of the "OpenDML AVI File Format Extensions" published by the OpenDML AVI M-JPEG File Format Subcommittee.
Related topics