DrvCopyBits 関数 (winddi.h)

DrvCopyBits 関数は、デバイス管理ラスターサーフェスと GDI 標準形式ビットマップの間で変換します。

構文

BOOL DrvCopyBits(
  SURFOBJ  *psoDest,
  SURFOBJ  *psoSrc,
  CLIPOBJ  *pco,
  XLATEOBJ *pxlo,
  RECTL    *prclDest,
  POINTL   *pptlSrc
);

psoDest

コピー操作の宛先 SURFOBJ 構造体へのポインター。

psoSrc

コピー操作のソース SURFOBJ 構造体へのポインター。

pco

宛先サーフェス上のクリップ領域を定義する CLIPOBJ 構造体へのポインター。

pxlo

ソースサーフェスとターゲットサーフェス間のカラーインデックスの変換を定義する XLATEOBJ 構造体へのポインター。 pxlo が NULL の場合、変換は必要ありません。

prclDest

変更する領域を定義する RECTL 構造体へのポインター。この構造体は、変換先サーフェスの座標系を使用します。この四角形の下端と右端は、ビットブロック転送の一部ではありません。つまり、四角形は右下に排他的です。

DrvCopyBits は、空の変換先の四角形で呼び出されることはありません。四角形を定義する 2 つの点は、常に適切な順序で並べ替えられます。

pptlSrc

ソース四角形の左上隅を定義する POINTL 構造体へのポインター。

ソースサーフェスがコピー先サーフェスに正常にコピーされた場合、戻り値は TRUE になります。

ドライバーは、必要に応じて DrvCopyBits をフックできます。その場合、あるサーフェスから別のサーフェスにコピーする必要があり、少なくとも 1 つのサーフェスがデバイスで管理されている場合、GDI は DrvCopyBits を呼び出します。

要件	値
対象プラットフォーム	デスクトップ
Header	winddi.h (Winddi.h を含む)