IDCompositionDevice2::CreateEffectGroup-Methode (dcomp.h)

Erstellt ein -Objekt, das mehrere Effekte darstellt, die auf eine visuelle Unterstruktur angewendet werden sollen.

Syntax

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

Parameter

[out] effectGroup

Typ: IDCompositionEffectGroup**

Das neue Effektgruppenobjekt. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Eine Effektgruppe ermöglicht es einer Anwendung, mehrere Effekte auf eine einzelne visuelle Unterstruktur anzuwenden.

Eine neue Effektgruppe hat den Standardtranspazitätswert 1,0 und keine 3D-Transformationen.

Verwenden Sie zum Festlegen der Deckkraft- und Transformationswerte die entsprechenden Methoden für die erstellte IDCompositionEffectGroup.To set the opacity and transform values, use the corresponding methods on the IDCompositionEffectGroup that was created.

Anforderungen

Weitere Informationen

IDCompositionDevice2

IDCompositionVisual::SetEffect