Función EngCreateBitmap (winddi.h)
La función EngCreateBitmap solicita que GDI cree y administre un mapa de bits.
Sintaxis
ENGAPI HBITMAP EngCreateBitmap(
SIZEL sizl,
LONG lWidth,
[in] ULONG iFormat,
[in] FLONG fl,
[in] PVOID pvBits
);
Parámetros
sizl
Especifica una estructura SIZEL cuyos miembros contienen el ancho y alto, en píxeles, del mapa de bits que se va a crear. Una estructura SIZEL es idéntica a una estructura SIZE .
Si pvBits no es NULL, este valor debe representar todos los píxeles visibles en el dispositivo, lo que permite que el dispositivo mantenga la memoria desactivada de la pantalla.
lWidth
Especifica el ancho de asignación del mapa de bits, que es el número de bytes que se deben agregar a un puntero para bajar una línea de examen.
[in] iFormat
Especifica el formato del mapa de bits en términos del número de bits de información de color por píxel que son necesarios. Este parámetro puede ser uno de los valores siguientes:
| Valor | Significado |
|---|---|
| BMF_1BPP | Monocromático |
| BMF_4BPP | 4 bits por píxel |
| 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 |
| BMF_4RLE | 4 bits por píxel; longitud de ejecución codificada |
| BMF_8RLE | 8 bits por píxel; longitud de ejecución codificada |
[in] fl
Es una máscara de bits que especifica las propiedades sobre el mapa de bits que se va a crear. Este parámetro puede ser cero o cualquier combinación de los valores siguientes:
| Value | Significado |
|---|---|
| BMF_NOZEROINIT | GDI no inicializará cero el mapa de bits al asignarlo. Esta marca solo se comprueba cuando pvBits es NULL. |
| BMF_TOPDOWN | La primera línea de examen representa la parte superior del mapa de bits. Tenga en cuenta que los mapas de bits de formato estándar tienen la primera línea de examen en la parte inferior de forma predeterminada. |
| BMF_USERMEM | GDI asignará la memoria para el mapa de bits de la memoria del usuario. De forma predeterminada, la memoria se asigna desde el espacio de direcciones del kernel. Esta marca solo se debe especificar cuando otros procesos no usen el mapa de bits que se va a crear. El controlador de impresora no puede pasar memoria de usuario a EngWritePrinter . |
[in] pvBits
Puntero a la primera línea de examen del mapa de bits que se va a crear. Si este parámetro es NULL, GDI asigna el espacio de almacenamiento para los píxeles del mapa de bits. Si pvBits no es NULL, es un puntero al búfer del mapa de bits.
Valor devuelto
Si la función se completa correctamente, el valor devuelto es un identificador que identifica el mapa de bits creado. De lo contrario, el valor devuelto es 0. EngCreateBitmap no registra un código de error.
Comentarios
Opcionalmente, el controlador puede proporcionar almacenamiento para el mapa de bits.
El controlador debe asociar el mapa de bits creado como una superficie llamando a EngAssociateSurface antes de volver de DrvEnableSurface.
El mapa de bits se debe eliminar mediante EngDeleteSurface cuando ya no sea necesario.
Los controladores de visualización del búfer de fotogramas deben usar el parámetro pvBits , lo que permite que GDI haga la mayoría de los dibujos directamente en la pantalla.
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |