Intermec 6100 Reference Guide

Page of 328
SECTION 3
Supporting Windows Applications
3-34    PEN*KEY
R
 6100 Computer Programmer’s Reference Guide
Supported PrtService Options
PrtService provides the following services:
"
Enable Driver.  Enables the driver and installs the default error handler.
wOpt should be set to PRT_ENABLE (0x0001)
lParam1 should be set to 0
lParam2 should be set to 0
"
Disable Driver.  Disables the driver.
wOpt should be set to PRT_DISABLE (0x0002)
lParam1 should be set to 0
lParam2 should be set to 0
"
Query Driver for support of an option.  Determines whether the driver supĆ
ports a particular feature.
wOpt should be set to PRT_GETSUPPORT (0x0003)
lParam1 should be set to the value of the option you want to check.
lParam2 should be set to 0
"
Install/Remove External Error handler.  Installs or removes the applicaĆ
tions error handler.
wOpt should be PRT_SETPROC (0x0010)
lParam1 should be a far pointer to your error handling procedure.  A valĆ
ue of 0 removes the handler.  Call MakeProcInstance(...) to get the value.
lParam2 should be set to 0
"
Flush Driver.  Flushes all the data buffers so that everything sent to the
printer actually gets printed.
wOpt should be set to PRT_FLUSH (0x0020)
lParam1 should be set to 0
lParam2 should be set to 0
Error Codes and Messages
As pointed out in the topic Default ErrorĆHandling Mode," the IrDA printer
driver can provide the error handler and thereby translate all printerĆrelated erĆ
rors into a Cancel or Retry option for any application.
However, if the application provides the error handler, custom messages can be
attached to the error returns.  As shown in this table, seven different numbered
returns are made available by the driver as generic hook points for messages.
Error #
Error
3
Wait
255
Failed
254
Error Queue Full
253
Error Node Active
252
Error Bad ConHandle
251
Media Busy
xxx
Unknown Error
Any of the listed errors can appear under 12 different operational phases or cateĆ
gories such as: Initialize, Discover, Discover TimeĆout, Connect, Connect Status
Error, Flush ć Allocate, Flush ć Get, Flush ćAppend, Flush Queue Full, Send,
Disconnect, and Shutdown.
3. Windows
Applications