EngCreateDeviceBitmap 函数 (winddi.h)

EngCreateDeviceBitmap 函数请求 GDI 为设备位图创建句柄。

语法

ENGAPI HBITMAP EngCreateDeviceBitmap(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

参数

[in] dhsurf

要创建的设备位图的设备句柄。

[in] sizl

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

iFormatCompat

指定所创建设备图面的兼容引擎格式。 如果需要临时缓冲区来模拟复杂的绘图调用,则 GDI 会使用此函数。 iFormatCompat 的允许值为 BMF_1BPP、BMF_4BPP、BMF_8BPP、BMF_16BPP、BMF_24BPP 和 BMF_32BPP。

返回值

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

注解

应使用 EngAssociateSurface 关联表面。 当不再需要位图时,应通过调用 EngDeleteSurface 将其删除。

要求

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

另请参阅

EngCreateBitmap