beautypg.com

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

Page 30

background image

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