Download PTQ ADM Dev Guide - ProSoft Technology

PTQ-ADM ♦ 'C' Programmable
‘C’ Programmable Network Interface Module for Quantum
Serial Port Library Functions
Developer Guide
MVIsp_GetCountUnread
Syntax
int MVIsp_GetCountUnread(int comport, int *count);
Parameters
comport
count
Desired communications port
Pointer to int to receive unread character count
Description
MVIsp_GetCountUnread returns the number of characters in the receive queue
that are waiting to be read. Since data received from a port is queued after
reception from a serial port, the application may need to determine if all
characters have been read or how many characters remain to be read.
comport is the desired serial port and must be previously opened with
MVIsp_Open.
count points to an int that will receive the number of characters that have been
received from the serial port but not read by the application. If the returned count
is 0, all received data has been read. If it is non-zero, it contains the number of
characters placed into the receive queue after reception from a serial port but
that have not been read from the queue with MVIsp_Getch, MVIsp_Gets, or
MVIsp_GetData.
Return Value
MVI_SUCCESS
MVI_ERR_NOACCESS
MVI_ERR_BADPARAM
Count retrieved successfully
comport has not been opened
Invalid pointer
Example
int count;
if (MVIsp_GetCountUnread(COM2,&count) == MVI_SUCCESS)
{
if (count == 0)
printf("All chars read\n");
else
printf("%d characters remaining\n",count);
}
See Also
MVIsp_Getch (page 209)
MVIsp_Gets (page 214)
MVIsp_GetData (page 216)
ProSoft Technology, Inc.
February 20, 2013
Page 219 of 239