EngCreateDeviceBitmap 函数 (winddi.h)

  • 项目

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

语法

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

参数

[in] dhsurf

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

[in] sizl

指定要创建的位图的宽度和高度的 SIZEL 结构。 此结构的 cx 和 cy 成员分别包含位图的宽度和高度（以像素为单位）。 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