Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
A device bitmap is any bitmap whose bitmap bits are stored in device memory
(such as RAM on a display adapter) instead of main memory. Device bitmaps
can significantly increase the performance of a graphics driver as well as
free main memory for other uses. To realize these benefits, the
corresponding graphics device must have ample video memory in addition to
the video memory used to generate the current display. The device should
also have efficient routines for copying bits to video memory.
 
Graphics drivers that set the RC_DEVBITS value in the dpRaster member of the
GDIINFO structure support device bitmaps. GDI checks this bit to determine
how to carry out requests to create and select bitmaps. If a driver sets the
RC_DEVBITS value, it must export the following functions:
 
♦  BitmapBits
 
♦  RealizeObject
 
♦  SelectBitmap
 
BitmapBits copies bitmap data to and from device bitmaps. GDI calls this
function when initializing the bitmap bits after creating the bitmap. It
also calls the function when an application calls the functions such as
GetBitmapBits (GDI.74) and SetBitmapBits (GDI.106).
 
RealizeObject creates or deletes a device bitmap. GDI calls this function
when creating the bitmap, specifying the OBJ_BITMAP style. RealizeObject is
responsible for allocating memory to the device as well as filling a
physical PBITMAP structure that GDI will use to identify the device bitmap.
If the bitmap is to be deleted, RealizeObject must free the device memory.
 
SelectBitmap associates a device bitmap with the given PDEVICE structure.
GDI passes the physical PBITMAP structures of both the currently selected
bitmap and the new bitmap so that SelectBitmap can carry out any special
processing to enable or disable access to the device bitmaps.
 
Device bitmaps cannot be monochrome bitmaps. GDI intercepts all requests to
create monochrome bitmaps and creates main memory bitmaps instead. This
means a graphics driver that supports device bitmaps must also be able to
support main memory bitmaps.
 
Note:  If the display driver supports device bitmaps, it must not fail any
       calls to the SelectBitmap, BitmapBits, or RealizeObject functions. If
       the driver cannot allocate more video memory for a requested bitmap,
       it must use GlobalAlloc to allocate system memory instead.
 
 
                                      ♦