drvLineTo 函式 (winddi.h)

發行項
08/27/2023

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檔。