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.

See Also

CreateCompatibleBitmap