CreateDiscardableBitmap function (wingdi.h)

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.

Syntax

HBITMAP CreateDiscardableBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parameters

[in] hdc

A handle to a device context.

[in] cx

The width, in pixels, of the bitmap.

[in] cy

The height, in pixels, of the bitmap.

Return value

If the function succeeds, the return value is a handle to the compatible bitmap (DDB).

If the function fails, the return value is NULL.

Remarks

When you no longer need the bitmap, call the DeleteObject function to delete it.

Requirements

See also

Bitmap Functions

Bitmaps Overview

CreateCompatibleBitmap

DeleteObject