SetCompositionMode method

  • Article

Sets the composition mode for the ISurfacePresenter interface.

 

Syntax

HRESULT retVal = object.SetCompositionMode(mode);

Parameters

mode [in]

Type: VIEW_OBJECT_COMPOSITION_MODE

A composition mode value.

VIEW_OBJECT_COMPOSITION_MODE_LEGACY

Uses legacy GDI technology (IViewObject::Draw) to render content in windowless controls. Causes any outstanding presentation objects to not return successfully for any operation.

VIEW_OBJECT_COMPOSITION_MODE_SURFACEPRESENTER

Causes the presenter to render the last presented front buffer. If ISurfacePresenter::Present has not been called, nothing is drawn.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.