### 函数功能

该函数创建与指定的设备环境相关的设备兼容的位图。

### 函数原型

HBITMAP CreateCompatibleBitmap(HDC hdc,int nWidth,int nHeight)；

### 参数

hdc： 设备环境句柄。
nWidth：指定位图的宽度，单位为像素。
nHeight：指定位图的高度，单位为像素。

### 返回值

如果函数执行成功，那么返回值是位图的句柄；如果函数执行失败，那么返回值为NULL。若想获取更多错误信息，请调用GetLastError。
备注：由CreateCompatibleBitmap函数创建的位图的颜色格式与由参数hdc标识的设备的颜色格式匹配。该位图可以选入任意一个与原设备兼容的内存设备环境中。由于内存设备环境允许彩色和单色两种位图。因此当指定的设备环境是内存设备环境时，由CreateCompatibleBitmap函数返回的位图格式不同。然而为非内存设备环境创建的兼容位图通常拥有相同的颜色格式，并且使用与指定的设备环境一样的色彩调色板。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：wingdi.h；库文件：gdi32.lib。