ID2D1EffectImpl::SetGraph 方法 (d2d1effectauthor.h)

呈现器调用此方法以提供一种指定其转换图和转换图形更改的方法的效果实现。

呈现器在以下情况下调用此方法:

  • 首次初始化效果时。
  • 如果效果的输入数发生更改。

语法

HRESULT SetGraph(
  ID2D1TransformGraph *transformGraph
);

参数

transformGraph

类型: ID2D1TransformGraph*

效果通过 SetDescription 调用描述其转换拓扑的图。

返回值

类型: HRESULT

如果作为 CreateEffect 调用的一部分调用,则会阻止初始化效果的错误。 如果效果在后续 SetGraph 调用中失败:

  • 错误将从导致效果输入数发生更改的属性方法返回。
  • 效果对象将置于错误状态,如果随后用于呈现,上下文将置于临时错误状态,该特定效果将无法呈现,失败将在下一次 EndDraw 或 Flush 调用中返回。

要求

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

另请参阅

ID2D1EffectImpl