drvTextOut 函式 (winddi.h)

DrvTextOut函式是 GDI 的進入點，會呼叫驅動程式，在指定的位置轉譯一組圖像。

語法

BOOL DrvTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  MIX      mix
);

參數

pso

SURFOBJ結構的指標，描述要寫入的介面。

pstro

STROBJ結構的指標，定義要呈現的字元，以及要放置圖像的位置。

pfo

要從中擷取字型及其字元相關資訊的 FONTOBJ 結構指標。

pco

CLIPOBJ結構的指標，該結構定義必須完成所有轉譯的剪輯區域。 驅動程式不會影響剪輯區域以外的任何圖元。

prclExtra

RECTL 結構的指標。 GDI 一律會將此參數設定為 Null ，以呼叫此函式。 驅動程式應該忽略它。

prclOpaque

代表單一不透明矩形之 RECTL 結構的指標。 這個矩形是右下角獨佔的。 此矩形內的圖元 (非前景且未裁剪) 會以不透明筆刷轉譯。 這個矩形一律會系結要繪製的文字。 如果此參數為 Null，則不會轉譯不透明圖元。

pboFore

BRUSHOBJ結構的指標，代表要用於前景圖元的筆刷物件。 此筆刷一律為純色筆刷。

pboOpaque

代表不透明圖元之 BRUSHOBJ 結構的指標。 此筆刷的前景和背景混合模式都假設為R2_COPYPEN。 除非驅動程式在DEVINFO結構的flGraphicsCaps成員中設定GCAPS_ARBRUSHOPAQUE功能位，否則一律會以純色筆刷呼叫。

pptlOrg

POINTL結構的指標，該結構定義兩個筆刷的筆刷原點。

mix

混合模式，定義要用於 pboFore 指向之筆刷的前景和背景點陣作業。 如需混合模式的詳細資訊，請參閱。

傳回值

如果函式成功，則傳回值為 TRUE ;否則為 FALSE。

備註

DrvTextOut的輸入參數會定義兩組圖元：前景和不透明。 驅動程式必須轉譯表面，讓結果與不透明圖元先以不透明筆刷轉譯的程式相同，然後使用前景筆刷轉譯前景圖元。 每個作業都受限於裁剪。

前景和不透明圖元會被視為在螢幕上筆刷色彩的螢幕。 字型的字元本身沒有色彩。

DrvTextOut的輸入參數會定義一組圖像圖元、一組額外的矩形、不透明矩形和剪輯區域。 驅動程式必須負責計算並轉譯前景和不透明圖元的集合。

GDI 保證 DrvTextOut 和 DrvDestroyFont 永遠不會重迭;因此，驅動程式可以在處理 DrvTextOut 呼叫時依賴快取的資訊。

混合模式會定義傳入模式應該如何與裝置介面上的資料混合。 MIX 資料類型包含兩個二進位點陣運算， (ROP2) 封裝成單一 ULONG 的值。 最低順序位元組會定義前景點陣運算;下一個位元組會定義背景點陣作業。 如需點陣作業碼的詳細資訊，請參閱Microsoft Windows SDK檔。

這是有條件的必要函式。

規格需求

目標平台	桌上型
標頭	winddi.h (包含 Winddi.h)

另請參閱

CLIPOBJ

DEVINFO

DrvDestroyFont

FONTOBJ

STROBJ

SURFOBJ