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 を返します。

要件

関連項目

ID2D1Bitmap