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

こちらもご覧ください

ID2D1Bitmap