IMixerPinConfig2 Interface

The IMixerPinConfig2 interface is exposed on the input pins of overlay mixer filters and contains methods that manipulate video color controls, if the VGA chip supports it.

This interface derives from the IMixerPinConfig interface.

Microsoft® DirectShow® implements this interface on the input pins of overlay mixer filters. You should implement this interface when you create filters that need to control video colors.

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

Methods in Vtable Order

IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IMixerPinConfig2 methods Description

SetOverlaySurfaceColorControls Sets the color control settings associated with the specified overlay surface.
GeOverlaySurfaceColorControls Retrieves the color control settings currently associated with the specified overlay surface.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IMixerPinConfig2 methods	Description
SetOverlaySurfaceColorControls	Sets the color control settings associated with the specified overlay surface.
GeOverlaySurfaceColorControls	Retrieves the color control settings currently associated with the specified overlay surface.

IMixerPinConfig2::GetOverlaySurfaceColorControls

IMixerPinConfig2 Interface

Retrieves the color control settings associated with the specified overlay surface.

Syntax

HRESULT GetOverlaySurfaceColorControls(
    LPDDCOLORCONTROL pColorControl
    ) PURE;

Parameters

pColorControl
[out] Address of a pointer to the DDCOLORCONTROL structure containing the color values currently applied to the specified surface.

Return Value

Returns an HRESULT value that depends on the implementation of the interface. If the allocator on the pin is not using an overlay surface, E_FAIL is returned.

IMixerPinConfig2::SetOverlaySurfaceColorControls

IMixerPinConfig2 Interface

Sets the color control settings associated with the specified overlay surface.

Syntax

HRESULT SetOverlaySurfaceColorControls(
    LPDDCOLORCONTROL pColorControl
    ) PURE;

Parameters

pColorControl
[in] Address of a pointer to the DDCOLORCONTROL structure containing the new values to be applied to the specified surface.

Return Value

Returns an HRESULT value that depends on the implementation of the interface. If the allocator on the pin is not using an overlay surface, E_FAIL is returned.