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 转换,因为它稍微快一些。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | dcomp.h |
Library | Dcomp.lib |
DLL | Dcomp.dll |
另请参阅
IDCompositionMatrixTransform3D