ID2D1Bitmap::CopyFromMemory メソッド

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

構文

virtual HRESULT CopyFromMemory(
  [in, optional]  const D2D1_RECT_U *dstRect,
  [in]            const void *srcData,
                  UINT32 pitch
) = 0;

パラメーター

• dstRect [in, optional]
  D2D1_RECT_U 現在のビットマップで、srcRect で指定された領域のコピー先となる左上隅の領域。
• srcData [in]
  void コピーするデータ。
• pitch
  UINT32 srcData に格納されたソース ビットマップのストライド (ピッチ)。ストライドはスキャンライン (メモリ内の 1 行のピクセル数) のバイト数です。ストライドは、"ピクセル幅 * ピクセルあたりのバイト数 + メモリ パディング" という数式を使用して計算できます。

戻り値

HRESULT

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

解説

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

無効なコピー先の四角形など、このメソッドに無効な入力を渡すと、イメージのゆがみやデバイス障害などの予期しない結果が生じる可能性があります。

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

要件

参照

ID2D1Bitmap