PC_PRINTER_LOAD_BMP

Loads a bitmap into memory ready for the PC_PRINTER_WRITE_BMP function.

Syntax:

call "PC_PRINTER_LOAD_BMP"  using        printer-handle
                           by reference bmpfilename
                           by reference bmp-id
                           returning    status-code

Parameters:

	Using call prototype (see Library Routines - Key)	Picture (32-bit systems)
printer-handle	cblt-x4-comp5	pic x(4) comp-5.
bmpfilename	pic x(n).	pic x(n).
bmp-id	cblt-x4-comp5	pic x(4) comp-5.
status-code	See Library Routines - Key

On Entry:

printer-handle	The printer handle returned when the printer was opened.
bmpfilename	The name of the bitmap to be loaded (the name should be terminated with a null or space).

On Exit:

bmp-id

A unique identifier for the loaded bitmap.

status-code

Printer status code:

0	Successful
3	Printer device not open
18	Failed to load bitmap
19	Invalid bitmap identifier

Comments:

This routine is available only in the Windows environment.

Example:

call "PC_PRINTER_LOAD_BMP" using printer-handle
                             by reference "mflogo.bmp" & x"0"
                             by reference bmp-id
                           returning  printer-retcode.