IVMRFilterConfig9::SetImageCompositor method

The SetImageCompositor method installs an application-provided image compositor object.

Syntax


HRESULT SetImageCompositor(
  [in]  IVMRImageCompositor9 *lpVMRImgCompositor
);

Parameters

lpVMRImgCompositor [in]

Pointer to the image compositor object provided by the application.

Return value

The method returns an HRESULT. Possible values include those in the following table.

Return codeDescription
E_FAIL

Cannot change the compositor when the VMR filter's pins are connected.

E_POINTER

NULL pointer.

S_OK

The method succeeded.

VFW_E_WRONG_STATE

The VMR is not in mixing mode.

 

Remarks

Use this method to replace the VMR's default compositor with a custom compositor provided by the application. The image compositor is a sub-component of the mixer. The mixer must be loaded, through a call to IVMRFilterConfig9::SetNumberOfStreams,

before the compositor can be specified. The VMR manages all reference counting on the IVMRImageCompositor9 interface.

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Vmr9.h

Library

Strmiids.lib

See also

Using the Video Mixing Renderer
IVMRFilterConfig9 Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft