IDCompositionEffectGroup::SetTransform3D-Methode (dcomp.h)

Legt das 3D-Transformationseffektobjekt fest, das die Rasterung der Visuals ändert, auf die diese Effektgruppe angewendet wird.

Syntax

HRESULT SetTransform3D(
  [in, optional] IDCompositionTransform3D *transform3D
);

Parameter

[in, optional] transform3D

Typ: IDCompositionTransform3D*

Zeiger auf eine IDCompositionTransform3D-Schnittstelle oder eine ihrer abgeleiteten Schnittstellen. Dieser Parameter kann 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

Diese Methode schlägt fehl, wenn transform3D ein ungültiger Zeiger ist oder wenn der Zeiger nicht von derselben IDCompositionDevice-Schnittstelle wie diese Effektgruppe erstellt wurde. Die Schnittstelle kann keine benutzerdefinierte Implementierung sein. mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.

Wenn der transform3D-Parameter NULL ist, wendet die Effektgruppe keine Perspektivtransformationen auf die Visuals an. Das Festlegen der Transformation auf NULL entspricht dem Festlegen der Transformation auf ein IDCompositionMatrixTransform3D-Objekt , bei dem die angegebene Matrix die Identitätsmatrix ist. Eine Anwendung sollte jedoch nach Möglichkeit eine NULL-Transformation verwenden, da sie etwas schneller ist.

Anforderungen

Weitere Informationen

IDCompositionEffectGroup

IDCompositionMatrixTransform3D

IDCompositionRotateTransform3D

IDCompositionScaleTransform3D

IDCompositionTransform3D

IDCompositionTranslateTransform3D