IMixerPinConfig Interface

  • Article
 
Microsoft DirectShow 9.0

IMixerPinConfig Interface

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.

In addition to the methods inherited from IUnknown, the IMixerPinConfig interface exposes the following methods.

Method Description
SetRelativePosition Sets the position of the stream in the display window.
GetRelativePosition Retrieves the position of the stream in the display window.
SetZOrder Sets the z-order of a particular video stream.
GetZOrder Retrieves the z-order of a particular video stream.
SetColorKey Sets the color key being used by a video stream.
GetColorKey Retrieves the color key being used by a video stream.
SetBlendingParameter Sets the blending parameter that defines how a secondary stream is blended with a primary stream.
GetBlendingParameter Retrieves the value of the blending parameter that defines how a secondary stream is blended with a primary stream.
SetAspectRatioMode Sets the aspect ratio correction mode for window resizing.
GetAspectRatioMode Retrieves the aspect ratio correction mode for window resizing.
SetStreamTransparent Sets the stream to transparent.
SetStreamTransparent Determines whether a stream is transparent.

Requirements

Header: Include Mpconfig.h.

Library: Use Strmiids.lib.