ID2D1Bitmap：：CopyFromRenderTarget 方法 (d2d1.h)

将指定区域从指定的呈现目标复制到当前位图。

语法

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [in, optional] const D2D1_RECT_U   *srcRect
);

参数

[in, optional] destPoint

类型： const D2D1_POINT_2U*

在当前位图中， srcRect 指定的区域复制到的区域的左上角。

[in] renderTarget

类型： ID2D1RenderTarget*

包含要复制的区域的呈现目标。

[in, optional] srcRect

类型： const D2D1_RECT_U*

要复制的 renderTarget 区域。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

此方法不会更新当前位图的大小。 如果源位图的内容不适合当前位图，则此方法将失败。 另请注意，此方法不执行格式转换，如果位图格式不匹配，此方法将失败。

如果位图在批处理中处于活动状态，则调用此方法可能会导致当前批处理刷新。 如果刷新的批处理未成功完成，此方法将失败。 但是，此方法不会清除刷新批处理时所基于的呈现器目标的错误状态。 失败的 HRESULT 和标记状态将在下一次调用 EndDraw 或 Flush 时返回。

在调用此方法之前，必须从呈现器目标中弹出所有剪辑和层。 如果当前已将任何剪辑或层应用于呈现器目标，则此方法返回 D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT 。

要求

最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1.h
Library	D2d1.lib
DLL	D2d1.dll

另请参阅

ID2D1Bitmap