ID2D1Factory1：：GetRegisteredEffects 方法 (d2d1_1.h)
返回当前注册的效果的类 ID 和对此工厂的全局效果。
语法
HRESULT GetRegisteredEffects(
[out] CLSID *effects,
UINT32 effectsCount,
[out] UINT32 *effectsReturned,
[out, optional] UINT32 *effectsRegistered
);
参数
[out] effects
类型： CLSID*
此方法返回时，包含一个效果数组。 如果未检索任何效果，则为 NULL。
effectsCount
类型： UINT32
效果数组的容量。
[out] effectsReturned
类型： UINT32*
此方法返回时，包含复制到效果中的效果数。
[out, optional] effectsRegistered
类型： UINT32*
此方法返回时，包含系统中当前注册的效果数。
返回值
类型： HRESULT
该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。
| HRESULT | 说明 |
|---|---|
| S_OK | 未发生错误。 |
| E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | effectsRegistered 大于 effectCount。 |
注解
类 ID 集将由 API 以原子方式返回。 其他线程注册或注销效果不会中断该集。
如果 effectsRegistered 大于 effectCount，则提供的数组仍将使用当前注册效果集填充到容量。 此方法返回注册到此工厂的所有全局效果和所有效果的 CLSID。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |