Carrol Touch TouchSystems CarrollTouch Prog, Руководство программиста

Страница: 185 / 274

Appendix C - TAPI Function Reference CARROLL TOUCH
C-6 Touch System Programmer’s Guide
GetReports (2)
Description
If any reports are available from the touch system, this function
transfers them to the report buffer. The length (in bytes) of the reports
transferred to the report buffer is returned in
CX
.
Call with
AX
= 2 (function number).
BX
= Segment of report buffer.
CX
= Size of report buffer (in bytes).
DX
= Offset of report buffer.
Returns
AX
= 2 (function number).
CX
= Number of bytes transferred to the report buffer.
0
= No reports available - no bytes transferred.
nonzero = Reports were available - number of bytes
transferred to the report buffer.
Notes
The report buffer is an area of memory in the application program that
is dedicated to receiving Smart-Frame Protocol reports. One or several
reports may be sent to the report buffer. Only complete reports are sent
to the report buffer. No partial reports are sent.
The buffer size value passed in
CX
is the maximum number of bytes
that the TAPI driver writes to the report buffer. If the number of bytes
that the TAPI driver has available to write to this buffer is greater than
this value, the excess bytes are discarded.
It is recommended that the report buffer be at least 64 bytes long. Since
the TAPI driver transfers a maximum of 512 bytes to the report buffer,
the maximum report buffer size necessary is 512 bytes.