EngCopyBits

EngCopyBits 関数は、デバイス管理ラスタサーフェスと GDI 標準フォーマットビットマップとの間の変換を行う。

EngCopyBits psoDest, psoSrc, pco, pxlo, prclDest, pptlSrc

psoDest : [var] コピー操作の宛先サーフェスを記述する SURFOBJ 構造体へのポインタ。
psoSrc : [var] コピー操作のソースサーフェスを記述する SURFOBJ 構造体へのポインタ。
pco : [var] 影響を受ける宛先サーフェスの領域を制限する CLIPOBJ 構造体へのポインタ。NULL 可。
pxlo : [var] ソースとターゲットのサーフェス間のカラーインデックスの変換を定義する XLATEOBJ 構造体へのポインタ。
prclDest : [var] 宛先サーフェスの座標系で変更する領域を定義する RECTL 構造体へのポインタ。矩形は右下を含まない。下辺と右辺はコピーの一部ではない。
pptlSrc : [var] ソース矩形の左上隅を定義する POINTL 構造体へのポインタ。

(プラグイン / モジュール : gdi32.dll)

解説

EngCopyBits 関数は、デバイス管理ラスタサーフェスと GDI 標準フォーマットビットマップとの間の変換を行う。

[戻り値]
関数が成功した場合、戻り値は TRUE となる。失敗した場合はエラーをログに記録し FALSE を返す。

[備考]
標準フォーマットビットマップは単一プレーン、パックドピクセル形式である。各走査線は 4 バイト境界に整列される。これらのビットマップは
1, 4, 8, 16, 24, または 32 bpp である。標準フォーマット型のリストは EngCreateBitmap
関数を参照。GDI はシミュレーションからこの関数を呼ぶ。EngCopyBits は空の宛先矩形では呼ぶべきでなく、宛先矩形の 2
点は整列していなければならない。すなわち、最初の点は矩形の左上頂点、2 番目の点は右下頂点を表すべきである。

情報