wingdi.h


CreateDiscartableBitmap

La función CreateDiscardableBitmap crea un mapa de bits descartable que es compatible con el dispositivo especificado. El mapa de bits tiene el mismo formato de bits por pixel y la misma paleta de colores que el dispositivo. Una aplicación puede seleccionar este mapa de bits como el actual para un dispositivo de memoria que sea compatible con el dispositivo especificado.

Esta función se incluye sólo por compatibilidad con versiones anteriores de Windows. Para aplicaciones basadas en Win32, usar la función CreateCompatibleBitmap.

Sintaxis

HBITMAP CreateDiscardableBitmap(
    HDC hdc,    // manipulador de contexto de dispositivo
    int nWidth, // anchura del mapa de bits
    int nHeight // altura del mapa de bits
   );

Parámetros

hdc: identifica un contexto de dispositivo.

nWidth: especifica la anchura del mapa de bits en pixels.

nHeight: especifica la altura del mapa de bits en pixels.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un manipulador del mapa de bits.

Si la función falla, el valor de retorno es NULL.

Observaciones

Cuando ya no se necesite el mapa de bits, hay que llamar a la función DeleteObject para borrarlo.