Frees a bitmap from memory, releasing its image and palette back to the operating system.
Syntax:
call "PC_PRINTER_FREE_BMP" using printer-handle
by value bmp-id
returning status-code
Parameters:
|
Using call prototype (see
Key)
|
Picture
|
printer-handle
|
cblt-x4-comp5
|
pic x(4) comp-5.
|
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.
-
bmp-id
- The unique id of the loaded bitmap, returned when the bitmap was loaded.
On Exit:
-
status-code
- Printer status code:
0
|
Successful
|
3
|
Printer device not open
|
20
|
Failed to free bitmap
|
Example:
call "PC_PRINTER_FREE_BMP" using printer-handle
by value bmp-idlogo
returning printer-retcode