Función CreateBitmapIndirect (wingdi.h)

La función CreateBitmapIndirect crea un mapa de bits con el ancho, alto y formato de color especificados (planos de color y bits por píxel).

Sintaxis

HBITMAP CreateBitmapIndirect(
  [in] const BITMAP *pbm
);

Parámetros

[in] pbm

Puntero a una estructura BITMAP que contiene información sobre el mapa de bits. Si una aplicación establece los miembros bmWidth o bmHeight en cero, CreateBitmapIndirect devuelve el identificador a un mapa de bits monocromo de 1 a 1 píxel.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el mapa de bits.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Esta función puede devolver los siguientes valores.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
Uno o varios de los parámetros de entrada no son válidos.
ERROR_NOT_ENOUGH_MEMORY
El mapa de bits es demasiado grande para que se asigne memoria.

Comentarios

La función CreateBitmapIndirect crea un mapa de bits dependiente del dispositivo.

Después de crear un mapa de bits, se puede seleccionar en un contexto de dispositivo llamando a la función SelectObject . Sin embargo, el mapa de bits solo se puede seleccionar en un contexto de dispositivo si el mapa de bits y el controlador de dominio tienen el mismo formato.

Aunque la función CreateBitmapIndirect se puede usar para crear mapas de bits de color, por motivos de rendimiento, las aplicaciones deben usar CreateBitmapIndirect para crear mapas de bits monocromáticos y CreateCompatibleBitmap para crear mapas de bits de color. Cada vez que se selecciona un mapa de bits de color de CreateBitmapIndirect en un contexto de dispositivo, el sistema debe asegurarse de que el mapa de bits coincide con el formato del contexto del dispositivo en el que se selecciona. Dado que CreateCompatibleBitmap toma un contexto de dispositivo, devuelve un mapa de bits que tiene el mismo formato que el contexto de dispositivo especificado. Por lo tanto, las llamadas posteriores a SelectObject son más rápidas con un mapa de bits de color de CreateCompatibleBitmap que con un mapa de bits de color devuelto desde CreateBitmapIndirect.

Si el mapa de bits es monocromo, los ceros representan el color de primer plano y los que representan el color de fondo para el contexto del dispositivo de destino.

Cuando ya no necesite el mapa de bits, llame a la función DeleteObject para eliminarlo.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

BITMAP

BitBlt

Funciones de mapa de bits

Información general sobre mapas de bits

CreateBitmap

CreateCompatibleBitmap

CreateDIBitmap

DeleteObject

SelectObject