ID2D1EffectContext：：CreateEffect 方法 (d2d1effectauthor.h)

为指定的类 ID 创建 Direct2D 效果。这与 ID2D1DeviceContext：：CreateEffect 相同，因此自定义效果可以创建其他效果并将其包装在转换中。

语法

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

effectId

类型： REFCLSID

用于创建效果的内置或注册的效果 ID。有关效果 ID 的列表，请参阅内置效果。

[out] effect

类型： ID2D1Effect**

此方法返回时，包含指向效果的指针的地址。

类型： HRESULT

此方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

HRESULT	说明
S_OK	未发生错误。
E_OUTOFMEMORY	Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG	传递给方法的值无效。
D3DERR_OUTOFVIDEOMEMORY	Direct3D 没有足够的显示内存来执行该操作。
D2DERR_EFFECT_IS_NOT_REGISTERED	系统未注册指定的效果。

创建的效果不对创建效果的 DLL 进行引用计数。如果调用方在加载此效果时取消注册效果，则结果行为不可预知。


最低受支持的客户端	适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	d2d1effectauthor.h
Library	D2D1.lib