Comtrol API (6508) for the MS-DOS User Manual
Page 30

30
API Functions
aaRead
COM_MDM_DTR
, or both. If
the flag is not set the line is
OFF
. If hardware flow control
is in use for a modem line, it’s
flag has no effect.
int: NO_ERR
if successful
ERR_DEV
if device number out of range
ERR_OPENTYPE
if invalid open type flag
ERR_BAUDRATE
if invalid baud rate flag
ERR_PAR
if invalid parity bits flag
ERR_DATAB
if invalid data bits flag
ERR_STOPB
if invalid stop bits flag
ERR_FLOW
if invalid flow control bits flag
ERR_DETECT
if invalid detect enable flag
ERR_MDMCTL
if invalid modem control flag
ERR_ALREADYOPEN
if device already open error
flag
If this device has been opened previously and is still
open, this function fails and returns an
ERR_ALREADYOPEN
error.
This function disables and enables interrupts.
Return
Comments
Warning
aaRead
Reads serial data from a device.
aaRead(Dev,Cnt,Buf)
int Dev
Device number
int Cnt
Maximum number of bytes
that can be read
unsigned char *Buf
Buffer to store the data in
int: Number of bytes readif successful
0
if no data available to be read
ERR_DEV
if device number out of range
ERR_NOTOPEN
if device not open for receive
This function reads data from the device’s receive
buffer without checking for receive errors. If receive
error information is needed, use the aaGetRxStatus()
and aaReadWithStatus() functions.
The Cnt parameter should not be greater than the size
of the Buf receive buffer.
Function
Purpose
Call
Return
Comments
Warning