ID2D1Bitmap::CopyFromMemory メソッド (d2d1.h)
指定した領域をメモリから現在のビットマップにコピーします。
構文
HRESULT CopyFromMemory(
[in, optional] const D2D1_RECT_U *dstRect,
[in] const void *srcData,
UINT32 pitch
);
パラメーター
[in, optional] dstRect
型: const D2D1_RECT_U*
現在のビットマップでは、 srcRect で指定された領域がコピーされる四角形。
[in] srcData
型: const void*
コピーするデータ。
pitch
種類: UINT32
srcData に格納されているソース ビットマップのストライド (ピッチ)。 ストライドは、スキャンライン (メモリ内の 1 行のピクセル) のバイト数です。 ストライドは、ピクセル幅 * ピクセルあたりのバイト数 + メモリ パディングの数式から計算できます。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 それ以外の場合は、 HRESULT エラー コードが返されます。
注釈
このメソッドは、現在のビットマップのサイズを更新しません。 ソース ビットマップの内容が現在のビットマップに収まらない場合、このメソッドは失敗します。 また、このメソッドは書式変換を実行しないことに注意してください。2 つのビットマップ形式が一致している必要があります。
このメソッドが無効な入力 (無効な変換先の四角形など) に渡された場合、イメージの歪みやデバイスの障害など、予測できない結果が生成される可能性があります。
このメソッドを呼び出すと、ビットマップがバッチでアクティブな場合、現在のバッチがフラッシュされる可能性があります。 フラッシュされたバッチが正常に完了しない場合、このメソッドは失敗します。 ただし、このメソッドは、バッチがフラッシュされたレンダー ターゲットのエラー状態をクリアしません。 失敗した 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 |