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 |