IDCompositionDevice2::CreateEffectGroup method (dcomp.h)

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

See also

IDCompositionDevice2

IDCompositionVisual::SetEffect