ID2D1Bitmap::CopyFromBitmap メソッド

指定されたビットマップの指定された領域を現在のビットマップにコピーします。

構文

virtual HRESULT CopyFromBitmap(
  [in, optional]  const D2D1_POINT_2U *destPoint,
  [in]            ID2D1Bitmap *bitmap,
  [in, optional]  const D2D1_RECT_U *srcRect
) = 0;

パラメーター

• destPoint [in, optional]
  D2D1_POINT_2U 現在のビットマップで、srcRect で指定された領域のコピー先となる領域の左上隅。
• bitmap [in]
  ID2D1Bitmap コピー元のビットマップ。
• srcRect [in, optional]
  D2D1_RECT_U コピーする bitmap の領域。

戻り値

HRESULT

メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.

解説

このメソッドは、現在のビットマップのサイズを更新しません。ソース ビットマップのコンテンツが現在のビットマップに収まらない場合、このメソッドは失敗します。また、このメソッドは形式変換を実行しないため、ビットマップ形式が一致しない場合は失敗することに注意してください。

このメソッドを呼び出すと、ビットマップがバッチ内でアクティブな場合に現在のバッチがフラッシュされることがあります。フラッシュされたバッチが正常に完了しなかった場合、このメソッドは失敗します。ただし、このメソッドは、バッチがフラッシュされたレンダー ターゲットのエラー状態をクリアしません。失敗した HRESULT とタグの状態は、次に EndDraw または Flush を呼び出したときに返されます。

要件

参照

ID2D1Bitmap