Edit

Share via

IAMVideoDecimationProperties interface (strmif.h)

  • Article

[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 IAMVideoDecimationProperties interface controls how the Overlay Mixer performs video decimation

If a video window is smaller than the native size of the video being displayed, the video renderer must decimate the incoming video—that is, scale the video down to the smaller size. Decimation can be performed in one of the following places.

  • The overlay hardware on the VGA chip.
  • The scaler built in to the video port (if the connection is through a video port).
  • The decoder supplying video to the renderer.
An application can call methods on this interface to select a particular decimation strategy, in order to optimize performance. However, most applications will have no occasion to use this interface. Unless your application is designed to support particular hardware, there is no reason to modify the Overlay Mixer filter's default behavior for decimation.

Inheritance

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

Methods

The IAMVideoDecimationProperties interface has these methods.

 
IAMVideoDecimationProperties::QueryDecimationUsage

The QueryDecimationUsage method retrieves the current decimation strategy.
IAMVideoDecimationProperties::SetDecimationUsage

The SetDecimationUsage method sets the decimation strategy.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)