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文档。