IDCompositionEffectGroup::SetTransform3D-Methode (dcomp.h)

Artikel
08/23/2023

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll