EngTransparentBlt 関数 (winddi.h)

[アーティクル]
03/04/2024

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

構文

ENGAPI BOOL EngTransparentBlt(
  [in]           SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in, optional] CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    TransColor,
  [in]           ULONG    bCalledFromBitBlt
);

パラメーター

[in] psoDst

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

[in] psoSrc

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

[in, optional] pco

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

[in, optional] pxlo

ターゲットサーフェスに書き込むためのソースカラーインデックスの変換方法を示す XLATEOBJ 構造体へのポインター。

[in] prclDst

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

ドライバーは、空の宛先の四角形で EngTransparentBlt を呼び出す必要があります。

[in] prclSrc

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

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

この四角形は、 prclDst によって定義された変換先の四角形にマップされます。ドライバーは、空のソース四角形を使用して EngTransparentBlt を呼び出してはなりません。

[in] TransColor

ソースサーフェスの形式で、物理的な透明色を指定します。これは、ソースサーフェスのパレットに変換されたカラーインデックス値です。詳細については、「解説」を参照してください。

[in] bCalledFromBitBlt

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

戻り値

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

注釈

ドライバーは 、DrvTransparentBlt をフックし、サポートされていない操作を実行するために呼び出される場合は、 EngTransparentBlt を呼び出す必要があります。

透過性を持つビットブロック転送は、2 つのデバイスで管理されるサーフェス間、またはデバイス管理サーフェスと GDI で管理される標準形式のビットマップの間でサポートされます。現在、GDI では、BMF_4BPPとBMF_8BPPソースサーフェスのみがサポートされています。

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	winddi.h (Winddi.h を含む)
Library	Win32k.lib
[DLL]	Win32k.sys