Carrol Touch TouchSystems CarrollTouch Prog, Programmer'S Manual

Page: 84 / 274

CARROLL TOUCH Chapter 6 - Touch Application Program Interface (TAPI)
Touch System Programmer’s Guide 6-7
Determining if a TAPI Driver Is Installed
An application program may determine if a TAPI driver is installed by
performing a string compare starting at the address pointed to by the
TAPI software interrupt 2. For all TAPI drivers, the first 9
characters read
CT DRIVER
. The type of driver is identified by an
additional string:
CT DRIVER - SBC
Identifies an SBC driver.
CT DRIVER - HBC
Identifies an HBC driver.
CT DRIVER - 232
Identifies an RS-232 driver.
Calling TAPI Functions
To call a TAPI function, load the registers as described in the “Call
with” sections for the TAPI functions described in Appendix C. Then,
Message:
TAPI driver installation failed.
Meaning: This error message accompanies other error messages
and indicates that installation was aborted due to the
stated condition.
Message:
Communication error - report expected
but not received.
Check that the touch system is
properly connected.
Meaning: The TAPI driver could not initialize the touch system
because a report that was expected was not received. A
timeout occurred while waiting for the report.
Message:
No TAPI driver resident at software
interrupt XXH. Uninstall aborted.
Meaning: An attempt is made to uninstall a TAPI driver at
software interrupt
XXH
, but no TAPI signature is
detected at that software interrupt.
Message:
The I/O Address Override (a) and
Interrupt Number override (i)
parameters must both be present in
order to override the I/O address and
interrupt number.
Meaning: One override parameter is present without the other.
Table 6-1. TAPI Error Messages and Explanations (Continued)