EngTransparentBlt 函式 (winddi.h)
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 結構的指標，定義要修改的矩形區域。 這個矩形是在目的地介面的座標系統中指定，並由兩個點定義：左上方和右下角。 矩形的右下角是獨佔的;也就是說，其下邊緣和右邊緣不是位區塊傳輸的一部分。 定義矩形的兩個點一律會妥善排序。
驅動程序絕對不能使用空的目的地矩形來呼叫 EngTransparentBlt 。
[in] prclSrc
RECTL 結構的指標，定義要複製的矩形區域。 這個矩形是在來源介面的座標系統中指定，並由兩個點定義：左上方和右下角。 定義矩形的兩個點一律會妥善排序。
來源矩形永遠不會超過來源表面的界限，因此永遠不會過度加總來源表面。
此矩形會對應至 中國lDst 所定義的目的地矩形。 驅動程序絕對不能使用空的來源矩形來呼叫 EngTransparentBlt 。
[in] TransColor
以來源表面的格式指定實體透明色彩。 這是已轉譯為來源表面調色盤的色彩索引值。 如需詳細資訊，請參閱備註一節。
[in] bCalledFromBitBlt
保留的。 此參數必須設定為零。
傳回值
EngTransparentBlt 會在成功時傳回 TRUE 。 否則會傳回 FALSE。
備註
如果驅動程式已連結DrvTransparentBlt，且呼叫它來執行不支援的內容，驅動程式應該呼叫EngTransparentBlt。
在兩個裝置管理的介面之間，或受 裝置管理的介面 與 GDI 管理的標準格式位圖之間，支援具有透明度的位塊傳輸。 目前，GDI 僅支援BMF_4BPP和BMF_8BPP來源介面。
不會複製符合 iTransparentColor 所指定透明色彩的來源介面圖元。 如需透明 blts 的詳細說明，請參閱 複製位圖。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包含Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |