Función DrvCreateDeviceBitmap (winddi.h)
La función DrvCreateDeviceBitmap crea y administra mapas de bits.
Sintaxis
HBITMAP DrvCreateDeviceBitmap(
DHPDEV dhpdev,
SIZEL sizl,
ULONG iFormat
);
Parámetros
dhpdev
Controle al PDEV que describe el dispositivo físico que una aplicación ha designado como destino principal para un mapa de bits. El formato del mapa de bits debe ser compatible con este dispositivo físico.
sizl
Especifica una estructura SIZEL que contiene el ancho y alto del mapa de bits que se va a crear. Los miembros cx y cy de esta estructura contienen respectivamente el ancho y el alto del mapa de bits, en píxeles. Una estructura SIZEL es idéntica a una estructura SIZE .
iFormat
Especifica el formato de mapa de bits, que indica el número necesario de bits de información de color por píxel y siempre coincide con el formato de la principal. Este valor puede ser uno de los siguientes:
| Value | Significado |
|---|---|
| BMF_8BPP | 8 bits por píxel. |
| BMF_16BPP | 16 bits por píxel. |
| BMF_24BPP | 24 bits por píxel. |
| BMF_32BPP | 32 bits por píxel. |
Valor devuelto
El valor devuelto es un identificador que identifica el mapa de bits creado si la función es correcta. Si el controlador decide permitir que GDI cree y administre el mapa de bits, el valor devuelto es cero. Si se produce un error, el valor devuelto es 0xFFFFFFFF y GDI registra un código de error.
Comentarios
Si el controlador crea el mapa de bits, puede almacenarlo en cualquier lugar y en cualquier formato. Se supone que el controlador tendrá en cuenta las especificaciones de los parámetros y proporcionará un mapa de bits con al menos tantos bits por píxel como se solicite.
El contenido del mapa de bits creado no está definido.
Esta función es opcional. Sin embargo, si se implementa esta función, también se debe implementar DrvDeleteDeviceBitmap .
Requisitos
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |