Specifications

Appendix D - CTKERN Function Reference CARROLL TOUCH
D-20 Touch System Programmer’s Guide
SendSmart-FrameProtocolCommandAnd
GetReport (18)
Description
This function sends one Smart-Frame Protocol command to the touch
system; the Smart-Frame Protocol report that the touch system sends
back is returned in the report buffer. The length (in bytes) of the report
transferred to the report buffer is also returned.
Call with
AL = 18 (function number).
BH = Smart-Frame Protocol command byte. The only SFP
commands valid for use with this function are
Get_Failed_Beam_Report (36H) and State_Report
(47H).
BL = Size of report buffer (in bytes).
CX = Segment of report buffer that holds the Smart-Frame
Protocol report received from the touch system.
DX = Offset of report buffer that holds the Smart-Frame
Protocol report received from the touch system.
Returns
AL = Smart-Frame Protocol command status.
00 = Smart-Frame Protocol command accepted.
01 = Invalid SFP command. An SFP command other
than Get_Failed_Beam_Report (36H) and
State_Report (47H) was sent.
CX = Number of bytes transferred to the report buffer.
0 = No bytes transferred (time out).
nonzero = Report was returned - number of bytes
transferred to the report buffer.
Notes
This function is normally not needed to create a touch application using
CTKERN. However, it does allow you to obtain touch screen
information that would otherwise be unobtainable because the touch
application is unable to make TAPI driver calls while using CTKERN.