EngCreateDeviceSurface 函数 (winddi.h)

EngCreateDeviceSurface 函数为驱动程序将管理的设备图面创建并返回句柄。

语法

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

参数

[in] dhsurf

要由设备管理的表面的设备句柄。 当为输入或输出传递 SURFOBJ 结构时,此句柄将传递给驱动程序。

[in] sizl

指定包含要创建的图面的宽度和高度的 SIZEL 结构。 此结构的 cxcy 成员分别包含图面的宽度和高度(以像素为单位)。 SIZEL 结构与 SIZE 结构相同。

iFormatCompat

指定要创建的设备图面的兼容引擎格式。 如果需要临时缓冲区来模拟复杂的绘图调用,则 GDI 会使用它。

返回值

如果函数成功,则返回值是标识图面的句柄。 否则,它为零,并记录错误代码。

注解

图面的存储空间可由驱动程序选择性地提供。 应使用 EngAssociateSurface 关联该图面。 使用 EngDeleteSurface 不再需要该图面时,应将其删除。

要求

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

另请参阅

EngAssociateSurface

EngDeleteSurface

SURFOBJ