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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | d2d1.h |
程式庫 | D2d1.lib |
Dll | D2d1.dll |