Microsoft DirectX 8.0

IMixerPinConfig2 Interface

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

This interface derives from the IMixerPinConfig interface.

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

Requirements

Requires Mpconfig.h.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IMixerPinConfig2 methodsDescription
SetOverlaySurfaceColorControls Sets the color control settings associated with the specified overlay surface.
GetOverlaySurfaceColorControls 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.