IAMVideoCompression interface (strmif.h)

The IAMVideoCompression interface sets and retrieves video compression properties. It is supported by some video compression filters, and also by some video capture filters that output compressed video. Filters that support this interface expose it through their output pins.

An application can use this interface to control how video is compressed, including characteristics such as the key-frame rate or the compression quality.

A filter that supports this interface might not support every method. Use the IAMVideoCompression::GetInfo method to determine which methods the filter supports.

Note  To use this interface on a capture filter, you might need to connect the filter to another filter in the graph.


The IAMVideoCompression interface inherits from the IUnknown interface. IAMVideoCompression also has these types of members:


The IAMVideoCompression interface has these methods.


The get_KeyFrameRate method retrieves the current key-frame rate.

The get_PFramesPerKeyFrame method retrieves the rate of predicted (P) frames per key frame.

The get_Quality method retrieves the current compression quality.

The get_WindowSize method retrieves the number of frames over which the compressor will maintain the average data rate.

The GetInfo method retrieves information about the filter's compression properties, including capabilities and default values.

The OverrideFrameSize method overrides the frame size of a specified frame.

The OverrideKeyFrame method instructs the filter to compress a particular frame as a key frame.

The put_KeyFrameRate method sets the key-frame rate.

The put_PFramesPerKeyFrame method sets the rate of predicted (P) frames per key frame.

The put_Quality method sets the compression quality.

The put_WindowSize method sets the number of frames over which the compressor must maintain an average data rate.


For Windows Driver Model (WDM) devices, the WDM Video Capture Filter automatically exposes this interface if the WDM driver supports the PROPSETID_VIDCAP_VIDEOCOMPRESSION property set. For more information, see the Windows Driver Kit (WDK) documentation.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)

See also