Share via

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

另请参阅

ID2D1Factory1

ID2D1Factory1：：RegisterEffect