IDCompositionEffectGroup：：SetTransform3D 方法 (dcomp.h)

设置 3D 转换效果对象，该对象修改应用此效果组的视觉对象的光栅化。

语法

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

[in, optional] transform3D

指向 IDCompositionTransform3D 接口或其派生接口之一的指针。此参数可以为 NULL。

类型： HRESULT

如果函数成功，则返回S_OK。否则，将返回 HRESULT 错误代码。有关错误代码的列表，请参阅 DirectComposition 错误代码。

如果 transform3D 是无效指针，或者此效果组不是由同一 IDCompositionDevice 接口创建的，则此方法失败。接口不能是自定义实现;只有 Microsoft DirectComposition 创建的接口才能与此方法一起使用。

如果 transform3D 参数为 NULL，则效果组不会对视觉对象应用任何透视转换。将转换设置为 NULL 等效于将转换设置为 IDCompositionMatrixTransform3D 对象，其中指定的矩阵是标识矩阵。但是，应用程序应尽可能使用 NULL 转换，因为它稍微快一些。