EngCopyBits 関数 (winddi.h)
EngCopyBits 関数は、デバイスで管理されるラスター サーフェスと GDI 標準形式のビットマップの間で変換されます。
構文
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
パラメーター
psoDest
コピー操作のコピー先サーフェスを記述する SURFOBJ 構造体へのポインター。
psoSrc
コピー操作のソースサーフェスを記述する SURFOBJ 構造体へのポインター。
pco
影響を受ける対象サーフェスの領域を制限する CLIPOBJ 構造体へのポインター。 このパラメーターは、NULL でもかまいません。
pxlo
ソース サーフェスとターゲット サーフェス間のカラー インデックスの平行移動を定義する XLATEOBJ 構造体へのポインター。
[in] prclDest
変更する変換先サーフェスの座標系内の領域を定義する RECTL 構造体へのポインター。 四角形は右下に排他的です。つまり、この四角形の下端と右端はコピーの一部ではありません。
[in] pptlSrc
ソース四角形の左上隅を定義する POINTL 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は TRUE です。 失敗した場合は、エラーをログに記録し、 FALSE を返します。
注釈
標準形式のビットマップは、単一平面のパックピクセル形式です。 各スキャン行は、4 バイト境界に配置されます。 これらのビットマップには、ピクセルあたり 1、4、8、16、24、または 32 ビットがあります。 標準の形式の種類の一覧については、 EngCreateBitmap 関数を参照してください。
GDI は、そのシミュレーションからこの関数を呼び出します。
EngCopyBits は、空の変換先の四角形で呼び出すべきではありません。また、変換先の四角形の 2 つのポイントは適切な順序である必要があります。つまり、最初の点は四角形の左上の頂点を表し、2 番目の点は右下の頂点を表す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | winddi.h (Winddi.h を含む) |
| Library | Win32k.lib |
| [DLL] | Win32k.sys |