EngCreateDeviceSurface 函数 (winddi.h)
EngCreateDeviceSurface 函数为驱动程序将管理的设备图面创建并返回句柄。
语法
ENGAPI HSURF EngCreateDeviceSurface(
[in] DHSURF dhsurf,
[in] SIZEL sizl,
ULONG iFormatCompat
);
参数
[in] dhsurf
要由设备管理的表面的设备句柄。 当为输入或输出传递 SURFOBJ 结构时,此句柄将传递给驱动程序。
[in] sizl
指定包含要创建的图面的宽度和高度的 SIZEL 结构。 此结构的 cx 和 cy 成员分别包含图面的宽度和高度(以像素为单位)。 SIZEL 结构与 SIZE 结构相同。
iFormatCompat
指定要创建的设备图面的兼容引擎格式。 如果需要临时缓冲区来模拟复杂的绘图调用,则 GDI 会使用它。
返回值
如果函数成功,则返回值是标识图面的句柄。 否则,它为零,并记录错误代码。
注解
图面的存储空间可由驱动程序选择性地提供。 应使用 EngAssociateSurface 关联该图面。 使用 EngDeleteSurface 不再需要该图面时,应将其删除。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 2000 及更高版本的 Windows 操作系统中可用。 |
目标平台 | 通用 |
标头 | winddi.h (包括 Winddi.h) |
Library | Win32k.lib |
DLL | Win32k.sys |