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、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1.h |
| Library | D2d1.lib |
| [DLL] | D2d1.dll |