EngCopyBits 函数 (winddi.h)

EngCopyBits 函数在设备管理的光栅图面和 GDI 标准格式位图之间转换。

语法

ENGAPI BOOL EngCopyBits(
       SURFOBJ  *psoDest,
       SURFOBJ  *psoSrc,
       CLIPOBJ  *pco,
       XLATEOBJ *pxlo,
  [in] RECTL    *prclDest,
  [in] POINTL   *pptlSrc
);

参数

psoDest

指向描述复制操作的目标图面的 SURFOBJ 结构的指针。

psoSrc

指向描述复制操作的源图面的 SURFOBJ 结构的指针。

pco

指向 CLIPOBJ 结构的指针,该结构限制将受影响的目标图面的区域。 此参数可以为 NULL。

pxlo

指向 XLATEOBJ 结构的指针,该结构定义源图面和目标图面之间的颜色索引转换。

[in] prclDest

指向 RECTL 结构的指针,该结构定义将修改的目标图面坐标系中的区域。 矩形是右下角独占的,这意味着此矩形的下边缘和右边缘不是副本的一部分。

[in] pptlSrc

指向定义源矩形左上角的 POINTL 结构的指针。

返回值

如果函数成功,则返回值为 TRUE 。 如果失败,它将记录错误并返回 FALSE

注解

标准格式位图是单平面、打包像素格式。 每条扫描线在 4 字节边界上对齐。 这些位图具有 1、4、8、16、24 或 32 位/像素。 有关标准格式类型的列表,请参阅 EngCreateBitmap 函数。

GDI 从其模拟中调用此函数。

不应使用空目标矩形调用 EngCopyBits,并且目标矩形的两个点必须井然有序;也就是说,第一个点应表示矩形的左上角顶点,第二个点应表示右下角顶点。

要求

要求
最低受支持的客户端 适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

CLIPOBJ

SURFOBJ

XLATEOBJ