ID2D1Factory1::GetEffectProperties 方法 (d2d1_1.h)

检索效果的属性。

语法

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

参数

[in] effectId

类型: REFCLSID

要从中检索属性的效果的 ID。

[out] properties

类型: ID2D1Properties**

此方法返回时,包含指向可用于查询效果元数据的属性接口的指针的地址。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
D2DERR_EFFECT_IS_NOT_REGISTERED 找不到请求的效果。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。

注解

返回的效果属性会将该效果的所有可变属性设置为 默认值 NULL 或空值。

  • 值类型将为零填充。
  • Blob 和字符串类型将为零长度。
  • 数组类型的长度为 1,数组的元素将符合前面的规则。
此方法不能用于返回 ID2D1DeviceContext::CreateEffect 不可见的任何效果的属性。

要求

要求
最低受支持的客户端 适用于 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::GetRegisteredEffects

ID2D1Factory1::RegisterEffect