Compartir a través de

Función DrvCreateDeviceBitmap (winddi.h)

  • Artículo

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)

Consulte también

DrvDeleteDeviceBitmap