IDCompositionVisual::SetCompositeMode method (dcomp.h)

Article
02/22/2024

Sets the blending mode for this visual.

Syntax

HRESULT SetCompositeMode(
  [in] DCOMPOSITION_COMPOSITE_MODE compositeMode
);

Parameters

[in] compositeMode

Type: DCOMPOSITION_COMPOSITE_MODE

The blending mode to use when composing the visual to the screen.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See DirectComposition Error Codes for a list of error codes.

Remarks

The composite mode determines how visual's bitmap is blended with the screen. By default, the visual is blended with "source over" semantics; that is, the colors are blended with per-pixel transparency.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	dcomp.h
Library	Dcomp.lib
DLL	Dcomp.dll