CreateDiscardableBitmap

HBITMAP CreateDiscardableBitmap(hDC, nWidth, nHeight)
HDC hDC;	/* handle of device context	*/
int nWidth;	/* bitmap width	*/
int nHeight;	/* bitmap height	*/

The CreateDiscardableBitmap function creates a discardable bitmap that is compatible with the device identified by the hDC parameter. The bitmap has the same bits-per-pixel format and the same color palette as the specified device. An application can select this bitmap as the current bitmap for a memory device that is compatible with the one specified by the hDC parameter.

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 Value

The return value identifies a bitmap if the function is successful. Otherwise, it is NULL.

Comments

Under Win32 this function is the same as CreateCompatibleBitmap and is included only for compatibility purposes.