DrvTransparentBlt 関数 (winddi.h)

[アーティクル]
08/27/2023

DrvTransparentBlt 関数は、透過性を備えたビットブロック転送機能を提供します。

構文

BOOL DrvTransparentBlt(
  [in, out]      SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in]           CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    iTransColor,
  [in]           ULONG    ulReserved
);

パラメーター

[in, out] psoDst

描画するターゲットサーフェスを識別する SURFOBJ 構造体へのポインター。

[in] psoSrc

ビットブロック転送のソースサーフェスを識別する SURFOBJ 構造体へのポインター。

[in] pco

CLIPOBJ 構造体へのポインター。 CLIPOBJ_Xxx サービスルーチンは、クリップ領域を一連の四角形として列挙するために提供されます。この列挙は、変更される宛先の領域を制限します。可能な限り、GDI は関連するクリッピングを簡略化します。

[in, optional] pxlo

ターゲットサーフェスへの書き込みのためにソースカラーインデックスを変換する方法を示す XLATEOBJ 構造体へのポインター。 pxlo が NULL の場合、変換は必要ありません。

[in] prclDst

変更する四角形領域を定義する RECTL 構造体へのポインター。この四角形は、変換先サーフェスの座標系で指定され、左上と右下の 2 つの点で定義されます。四角形は右下の排他的です。つまり、その下端と右端は、ビットブロック転送の一部ではありません。四角形を定義する 2 つの点は、常に適切に並べ替えられます。

DrvTransparentBlt は、空の変換先の四角形で呼び出されることはありません。

[in] prclSrc

コピーする四角形領域を定義する RECTL 構造体へのポインター。この四角形は、ソースサーフェスの座標系で指定され、左上と右下の 2 つの点で定義されます。四角形を定義する 2 つの点は、常に適切に並べ替えられます。

ソースの四角形がソースサーフェスの境界を超えることはなく、ソースサーフェスがオーバーハングすることはありません。

この四角形は、 prclDst によって定義された変換先の四角形にマップされます。 DrvTransparentBlt は、空のソース四角形で呼び出されることはありません。

[in] iTransColor

ソースサーフェス形式の物理的な透明色を指定します。パレットを持つデバイスの場合、この値はパレットインデックスです。パレットのないデバイスの場合、この値はソースサーフェスで使用される形式の RGB 色です。たとえば、ソースサーフェス形式が 5:6:5 RGB 形式の場合、このパラメーターの値も同じ形式になります。

[in] ulReserved

予約;このパラメーターは 0 に設定する必要があります。

戻り値

DrvTransparentBlt は、成功すると TRUE を 返します。それ以外の場合は、 FALSE を返します。

注釈

必要に応じて、グラフィックスドライバーに DrvTransparentBlt 関数を実装できます。

透過性を使用したビットブロック転送は、2 つのデバイス管理サーフェス間、またはデバイス管理サーフェスと GDI マネージド標準形式ビットマップの間でサポートされます。ドライバーライターは、ビデオメモリ内のオフスクリーンデバイスビットマップからビデオメモリ内の他のサーフェスへの blting のケースをサポートすることをお勧めします。他のすべてのケースは、パフォーマンスの低下がほとんどなく EngTransparentBlt にパントできます。ドライバーは、デバイスで管理されたサーフェスを含む呼び出しを EngTransparentBlt にパントできます。

iTransColor で指定された透明色に一致するソースサーフェス上のピクセルはコピーされません。透過的な blts の詳細については、「ビットマップのコピー」を参照してください。

ドライバーは、同じサーフェス上に重複するソースと宛先の四角形で呼び出されることはありません。

ドライバーは、ビットマップ形式が 5:5:5 (赤、緑、青のそれぞれ 5 ビット) の場合、最も重要なビットなど、カラーキー比較で使用されていないビットを無視する必要があります。

ドライバーは、EngAssociateSurface を呼び出すときに HOOK_TRANSPARENTBLT フラグを設定することで、DrvTransparentBlt をフックします。ドライバーが DrvTransparentBlt をフックし、サポートされていない操作を実行するために呼び出された場合、ドライバーは EngTransparentBlt への呼び出しでデータを転送することによって GDI が操作を処理する必要があります。