Specifications

No
EPSON
TITLE
EPSON Advanced Printer Driver for TM series
StatusAPI
Reference Manual
Revision
L
NEXT
9
SHEET
8
3.1.1. Acquiring the Status Using BiGetStatus
Using BiGetStatus, the application can acquire the printer’s status when necessary as shown in the following figure.
•
If the monitored printer is opened by
BiOpenMonPrinter(), Status API reads the printer
status at that point in time. After that, the Status API
reads and saves the printer status each time there is a
change in status.
•
If BiGetStatus() is called, The printer status which is
being saved by the Status API at that point in time is
returned to the application
• If BiCloseMonPrinter() is called, the Status API
closes monitoring of the printer status.
3.1.2. Acquiring the Status Using BiSetStatusBackFunction
If BiSetStatusBackFunction is used and a method of acquiring auto status notifications is registered, each time the printer
status changes, the new status can be acquired through calling of the callback function.
• If the monitored printer is opened by
BiOpenMonPrinter(), the status API the printer
status at that moment is read.
• If BiSetStatusBackFunction() is called and the
callback function is registered, the Status API
calls the callback function and notifies it of the
printer status at that point in time. After that,
each time there is a change in the printer status,
the Status API calls the callback function and
notifies it of the new printer status.
• If BiCancelStatusBack() is called, status
notification by calling the callback function is
not performed thereafter.
•
If BiCloseMonPrinter() is called, the Status API
closes monitoring of the printer status.
Application
Status Monitor
API
Printer
BiOpenM onPrinter()
BiG etS ta tu s()
BiG etS ta tu s()
BiG etS ta tu s()
BiCloseM onP rinter()
Status
New Status
New Status
New Status
Status Change
Status Change
Status Change
Flow of Status using BiG etS ta tu s
A pplication
Status Monitor
API
Printer
BiOpenM onPrinter()
BiS e tS ta tu sB a ck F u n ction()
BiCancelStatusBack()
Status
New Status
New Status
New Status
Status Change
Status Change
Flow of Status Using BiS etS ta tu sB a ck Function
Callback Function Call
Callback Function Call
BiCloseM onP rinter()
New Status
Status Change
Status Change
Callback Function Call
Callback Function Call