共用方式為


drvLineTo 函式 (winddi.h)

DrvLineTo函式會繪製單一實心的純整數外觀線條。

語法

BOOL DrvLineTo(
  SURFOBJ  *pso,
  CLIPOBJ  *pco,
  BRUSHOBJ *pbo,
  LONG     x1,
  LONG     y1,
  LONG     x2,
  LONG     y2,
  RECTL    *prclBounds,
  MIX      mix
);

參數

pso

SURFOBJ結構的指標,描述要繪製的介面。

pco

CLIPOBJ結構的指標,該結構定義必須完成轉譯的剪輯區域。 此剪輯區域外無法影響任何圖元。

pbo

BRUSHOBJ結構的指標,指定繪製線條時要使用的筆刷。

x1

指定線條起點的整數 X 座標。

y1

指定線條起點的整數 Y 座標。

x2

指定線條終點的整數 X 座標。

y2

指定線條終點的整數 Y 座標。

prclBounds

RECTL結構的指標,該結構定義系結未調整線條的整數矩形。 支援硬體線條繪製的驅動程式可以使用這個矩形,快速判斷線條是否適合足以由硬體轉譯的座標空間。

mix

混合模式,定義用於筆刷的前景和背景點陣作業。 在 對 DrvLineTo的呼叫中,前景和背景點陣作業值相同。 如需混合模式的詳細資訊,請參閱。

傳回值

DrvLineTo 如果成功,則會傳回 TRUE ;否則會傳回 FALSE

備註

DrvLineTo 是驅動程式可以提供作為 Win32 LineTo 函式應用程式呼叫優化的選擇性進入點。 如果驅動程式沒有攔截 DrvLineTo,或驅動程式從呼叫此函式傳回 FALSE ,GDI 會自動呼叫 DrvStrokePath 。 在轉譯介面為DIB時,已連結DrvLineTo的驅動程式可以呼叫EngLineTo

此函式比 DrvStrokePath 簡單,因為它只支援整數端點和實心外觀線條。 呼叫 DrvLineTo 而不是DrvStrokePath時,GDI 的額外負荷較少;因此, DrvLineTo 是用來做為可加速硬體中標準寬度線的驅動程式的簡單優化。

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

規格需求

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

另請參閱

BRUSHOBJ

CLIPOBJ

DrvStrokePath

EngLineTo

SURFOBJ