IDCompositionDevice2::CreateEffectGroup method (dcomp.h)

Article
02/22/2024

Creates an object that represents multiple effects to be applied to a visual subtree.

Syntax

HRESULT CreateEffectGroup(
  [out] IDCompositionEffectGroup **effectGroup
);

Parameters

[out] effectGroup

Type: IDCompositionEffectGroup**

The new effect group object. This parameter must not be NULL.

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

An effect group enables an application to apply multiple effects to a single visual subtree.

A new effect group has a default opacity value of 1.0 and no 3D transformations.

To set the opacity and transform values, use the corresponding methods on the IDCompositionEffectGroup that was created.

Requirements

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