DrvCreateDeviceBitmap 函数 (winddi.h)

  • 项目

DrvCreateDeviceBitmap 函数创建和管理位图。

语法

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

参数

dhpdev

PDEV 的句柄，描述应用程序指定为位图主目标的物理设备。 位图的格式必须与此物理设备兼容。

sizl

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

iFormat

指定位图格式，该格式指示每个像素所需的颜色信息位数，并且始终与主要格式匹配。 此值可以为下列值之一：

值 含义
BMF_8BPP 每像素 8 位。
BMF_16BPP 每像素 16 位。
BMF_24BPP 每像素 24 位。
BMF_32BPP 每像素 32 位。

返回值

如果函数成功，则返回值是标识创建的位图的句柄。 如果驱动程序选择让 GDI 创建和管理位图，则返回值为零。 如果发生错误，则返回值为0xFFFFFFFF，GDI 会记录错误代码。

注解

如果驱动程序创建位图，则它可以以任何格式存储在任何位置。 假定驱动程序将考虑参数的规范，并提供至少与请求的每个像素一样多位的位图。

创建的位图的内容未定义。

此函数是可选的。 但是，如果实现此函数，还必须实现 DrvDeleteDeviceBitmap 。

要求

   
目标平台 桌面
标头 winddi.h (包括 Winddi.h)

另请参阅

DrvDeleteDeviceBitmap