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) |