IMixerPinConfig interface (mpconfig.h)

[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 IMixerPinConfig interface is exposed on the input pins of the Overlay Mixer filter and contains methods that manipulate video streams in various ways. The Overlay Mixer contains multiple input pins that are dynamically created as video input streams are added. The video stream on the first pin is known as the primary stream and subsequent streams are known as secondary streams.

Use this interface to manipulate the parameters involved in mixing various video streams. These parameters include getting and setting position, z-order, blending and transparency levels, aspect ratio correction, and color keys of streams.

When setting the position of video streams in the display window, the default relative position of all secondary streams is {0, 0, 0, 0}. Therefore, use the IMixerPinConfig::SetRelativePosition method on secondary streams to ensure that all video streams are placed properly.

Applications use this interface to get and set attributes when mixing multiple video streams.

Inheritance

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

Methods

The IMixerPinConfig interface has these methods.

 
IMixerPinConfig::GetAspectRatioMode

The GetAspectRatioMode method retrieves the aspect ratio correction mode for window resizing.
IMixerPinConfig::GetBlendingParameter

The GetBlendingParameter method retrieves the value of the blending parameter that defines how a secondary stream is blended with a primary stream.
IMixerPinConfig::GetColorKey

The GetColorKey method retrieves the color key being used by a video stream.
IMixerPinConfig::GetRelativePosition

The GetRelativePosition method retrieves the position of the stream in the display window.
IMixerPinConfig::GetStreamTransparent

The GetStreamTransparent method determines whether a stream is transparent.
IMixerPinConfig::GetZOrder

The GetZOrder method retrieves the z-order of a particular video stream.
IMixerPinConfig::SetAspectRatioMode

The SetAspectRatioMode method sets the aspect ratio correction mode for window resizing.
IMixerPinConfig::SetBlendingParameter

The SetBlendingParameter method sets the blending parameter that defines how a secondary stream is blended with a primary stream.
IMixerPinConfig::SetColorKey

The SetColorKey method sets the color key being used by a video stream.
IMixerPinConfig::SetRelativePosition

The SetRelativePosition method sets the position of the stream in the display window.
IMixerPinConfig::SetStreamTransparent

The SetStreamTransparent method sets the stream to transparent.
IMixerPinConfig::SetZOrder

The SetZOrder method sets the z-order of a particular video stream.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mpconfig.h