COMM-DRV/Lib: IsInputOverrun() Returns true if the COMM-DRV receive buffer was overrun

Description-

Returns true if an overrun error occurred since the last call to this function. There are two types of overrun. One is a hardware overrun which means that the UART got another character before COMM-DRV/LIB was able to process the previous character. The second type of overrun occurs if the COMM-DRV/LIB ring buffers (the buffer whose buffer size was given in the InitializePort() or OpenComPort() function). This function returns the ring buffer overrun condition. The function IsOverrunError() returns the hardware overrun condition.

Syntax-

stat = IsInputOverrun(port);

On Entry-

int port;

Port previously opened with OpenComPort().

On Exit-

int stat;

0 If overrun error did not occur.

1 If overrun error occurred.

See Also-

IsBreak()
IsCarrierDetect()
IsCts()
IsDsr()
IsFramingError()
IsInputOverrun()
IsOverrunError()
IsParityError()
IsRing()

Example-

#include “comm.h”

int port=0;
int stat;

if ((stat = IsInputOverrun(port)) == 1)
{
printf(“Overrun Error occurred\n”);
}