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

要件

こちらもご覧ください

ID2D1Bitmap