A file that demonstrates how to write a Unidrv-based bitmap driver is available for Windows XP DDK and for Windows Server 2003 (893388)

MORE INFORMATION

Features of the BitMapSample.exe file

• The following supported ColorMode options are included in the generic printer description (GPD) of the bitmap driver:
  • Monochrome
  • 4 bits per pixel (bpp)
  • 8bpp
  • 24bpp
• The bitmap driver implements the ImageProcessing callback function in order to obtain access to bitmap data one band at a time. The implementation of the ImageProcessing callback function by the bitmap driver buffers the bitmap data every time that the bitmap data is called.
  
  Note The ImageProcessing callback function is also responsible for filling in the BITMAPINFOHEADER structure and the COLORTABLE structure. Both of these structures are required for exporting the bitmap data to a bitmap file.
• When you print a document, the bitmap driver implements the OEMEndDoc Device Driver Interface (DDI) hook in order to send the bitmap data to the spooler at the end of the print job. After the bitmap driver implements the OEMEndDoc DDI hook, the bitmap driver sends the document headers, and then the bitmap data, to the spooler.
• The GrowBuffer helper function is called every time that the buffer must be enlarged to hold the bitmap data.
• The bitmap driver renders multi-page documents into one large output bitmap file.

Known issues in the BitMapSample.exe file

• The plug-in for the bitmap driver does not support landscape orientation even though the landscape orientation option is present in the generic printer description (GPD) file.
• In 24bpp mode, documents that are larger than three pages produce a very large bitmap (.bmp) file. Although the output is correct, you may not be able to view the output because of memory limitations in the bitmap viewer.