CreateDiscardableBitmap
The CreateDiscardableBitmap
function creates a discardable bitmap that is compatible with the specified
device. The bitmap has the same bits-per-pixel format and the same color
palette as the device. An application can select this bitmap as the current
bitmap for a memory device that is compatible with the specified device.
The CreateDiscardableBitmap
function is included only for compatibility with earlier versions of Windows.
For Win32-based applications, use the CreateCompatibleBitmap function.
HBITMAP CreateDiscardableBitmap(
|
HDC hdc, |
// handle to device
context |
|
int nWidth, |
// bitmap width |
|
int nHeight |
// bitmap height |
|
); |
|
Parameters
hdc
Identifies a
device context.
nWidth
Specifies the
width, in bits, of the bitmap.
nHeight
Specifies the
height, in bits, of the bitmap.
Return Values
If the
function succeeds, the return value is a handle to the bitmap.
If the
function fails, the return value is NULL.
Remarks
When you no
longer need the bitmap, call the DeleteObject function to delete it.
See Also