ID2D1Bitmap：：CopyFromBitmap 方法 (d2d1.h)
将指定区域从指定的位图复制到当前位图。
语法
HRESULT CopyFromBitmap(
[in, optional] const D2D1_POINT_2U *destPoint,
[in] ID2D1Bitmap *bitmap,
[in, optional] const D2D1_RECT_U *srcRect
);
参数
[in, optional] destPoint
类型： const D2D1_POINT_2U*
在当前位图中， srcRect 指定的区域复制到的区域的左上角。
[in] bitmap
类型： ID2D1Bitmap*
要从中复制的位图。
[in, optional] srcRect
类型： const D2D1_RECT_U*
要复制的 位图 区域。
返回值
类型： HRESULT
如果该方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。
注解
此方法不会更新当前位图的大小。 如果源位图的内容不适合当前位图，则此方法将失败。 另请注意，此方法不执行格式转换，如果位图格式不匹配，此方法将失败。
如果位图在批处理中处于活动状态，则调用此方法可能会导致当前批处理刷新。 如果刷新的批处理未成功完成，此方法将失败。 但是，此方法不会清除刷新批处理时所基于的呈现器目标的错误状态。 失败的 HRESULT 和标记状态将在下一次调用 EndDraw 或 Flush 时返回。
从 Windows 8.1 开始，此方法支持块压缩位图。 如果使用块压缩格式， 则 srcRect 参数的结束坐标必须为 4 的倍数，否则方法返回 E_INVALIDARG。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 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 |