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 |