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
| 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 |
Weitere Informationen
IDCompositionMatrixTransform3D