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 |
|---|---|
|
Uno o varios de los parámetros de entrada no son válidos. |
|
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 |