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