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 |