ClearCommError(hComm,&dwError,&ComStat);//检查串口接收缓冲区中的数据个数 bResult=ReadFile(hComm, //串口句柄 ucRxBuff, //输入缓冲区地址 ComStat.cbInQue, //想读入的字符数 &BytesRead, //实际读出的字节数的变量指针 &ov_Read); //重叠结构指针 假如当前串口中有5个字节数据的话，那么执行完ClearCommError()函数后，ComStat 结构中的ComStat.cbInQue将被填充为5，此值在ReadFile函数中可被直接利用。 （7）ClearCommError() 用途：清除串口错误或者读取串口现在的状态 原型：BOOL ClearCommError(HANDLE hFile, LPDWORD lpErrors, LPCOMATAT lpStat ); 参数说明: -hFile:串口句柄 -lpErrors：返回错误数值，错误常数如下： 1-CE_BREAK:检测到中断信号。意思是说检测到某个字节数据缺少合法的停止位。 2-CE_FRAME:硬件检测到帧错误。 3-CE_IOE:通信设备发生输入/输出错误。 4-CE_MODE:设置模式错误，或是hFile值错误。 5-CE_OVERRUN:溢出错误，缓冲区容量不足，数据将丢失。 6-CE_RXOVER:溢出错误。 7-CE_RXPARITY:硬件检查到校验位错误。 8-CE_TXFULL:发送缓冲区已满。 -lpStat:指向通信端口状态的结构变量，原型如下： typedef struct _COMSTAT{ ... ... DWORD cbInQue; //输入缓冲区中的字节数 DWORD cbOutQue;//输出缓冲区中的字节数 }COMSTAT,*LPCOMSTAT; 该结构中对我们很重要的只有上面两个参数，其他的我们可以不用管。 操作举例：COMSTAT ComStat; DWORD dwError=0; ClearCommError(hComm,&dwError,&ComStat); 上式执行完后，ComStat.cbInQue就是串口中当前含有的数据字节个数，我们利用此 数值就可以用ReadFile()函数去读串口中的数据了。 （8）PurgeComm() 用途：清除串口缓冲区 原型：BOOL PurgeComm(HANDLE hFile, DWORD dwFlags ); 参数说明： -hFile:串口句柄 -dwFlags：指定串口执行的动作，由以下参数组成： -PURGE_TXABORT:停止目前所有的传输工作立即返回不管是否完成传输动作。 -PURGE_RXABORT:停止目前所有的读取工作立即返回不管是否完成读取动作。 -PURGE_TXCLEAR:清除发送缓冲区的所有数据。 -PURGE_RXCLEAR:清除接收缓冲区的所有数据。 操作举例：PurgeComm(hComm, PURGE_RXCLEAR|PURGE_TXCLEAR|PURGE_RXABORT|PURGE_TXABORT); 清除串口的所有操作。 （9）SetCommMask() 用途：设置串口通信事件。 原型：BOOL SetCommMask(HANDLE hFile, DWORD dwEvtMask ); 参数说明： -hFile：串口句柄 -dwEvtMask：准备监视的串口事件掩码 注：在用api函数撰写串口通信函数时大体上有两种方法，一种是查寻法，另外一种是事件通知法。 这两种方法的区别在于收串口数据时，前一种方法是主动的周期性的查询串口中当前有没有 数据；后一种方法是事先设置好需要监视的串口通信事件，然后依靠单独开设的辅助线程进行 监视该事件是否已发生，如果没有发生的话该线程就一直不停的等待直到该事件发生后，将 该串口事件以消息的方式通知主窗体，然后主窗体收到该消息后依据不同的事件性质进行处理。 比如说当主窗体收到监视线程发来的RX_CHAR(串口中有数据)的消息后，就可以用ReadFile() 函数去读串口。该参数有如下信息掩码位值： EV_BREAK:收到BREAK信号 EV_CTS:CTS(clear to send)线路发生变化 EV_DSRST(Data Set Ready)线路发生变化 EV_ERR:线路状态错误，包括了CE_FRAME\CE_OVERRUN\CE_RXPARITY 3钟错误。 EV_RING:检测到振铃信号。 EV_RLSD:CD(Carrier Detect)线路信号发生变化。 EV_RXCHAR:输入缓冲区中已收到数据。 EV_RXFLAG:使用SetCommState()函数设置的DCB结构中的等待字符已被传入输入缓冲区中。 EV_TXEMPTY:输出缓冲区中的数据已被完全送出。 操作举例：SetCommMask(hComm,EV_RXCHAR|EV_TXEMPTY); 上面函数执行完毕后将监视串口中有无数据和发送缓冲区中的数据是否全部发送完毕。 （10）WaitCommEvent() 用途：用来判断用SetCommMask()函数设置的串口通信事件是否已发生。 原型：BOOL WaitCommEvent(HANDLE hFile, LPDWORD lpEvtMask, LPOVERLAPPED lpOverlapped ); 参数说明： -hFile：串口句柄 -lpEvtMask:函数执行完后如果检测到串口通信事件的话就将其写入该参数中。 -lpOverlapped：异步结构，用来保存异步操作结果。 操作举例：OVERLAPPED os; DWORD dwMask,dwTrans,dwError=0,err;
memset(&os,0,sizeof(OVERLAPPED)); os.hEvent=CreateEvent(NULL,TRUE,FALSE,NULL); if(!WaitCommEvent(hComm,&dwMask,&os)){ //如果异步操作不能立即完成的话,函数返回FALSE,并且调用GetLastError()函 //数分析错误原因后返回ERROR_IO_PENDING,指示异步操作正在后台进行.这种情 //况下,在函数返回之前系统设置OVERLAPPED结构中的事件为无信号状态,该函数 //等待用SetCommMask()函数设置的串口事件发生，共有9种事件可被监视： //EV_BREAK，EV_CTS，EV_DSR，EV_ERR，EV_RING，EV_RLSD，EV_RXCHAR， //EV_RXFLAG，EV_TXEMPTY；当其中一个事件发生或错误发生时，函数将 //OVERLAPPED结构中的事件置为有信号状态，并将事件掩码填充到dwMask参数中 if(GetLastError()==ERROR_IO_PENDING){ GetOverlappedResult(hComm,&os,&dwTrans,true); switch(dwMask){ case EV_RXCHAR: PostMessage(Parent,WM_COMM_RXCHAR,0,0); break; case EV_TXEMPTY: PostMessage(Parent,WM_COMM_TXEMPTY,0,0); break; case EV_ERR: switch(dwError){ case CE_FRAME: err=0; break; case CE_OVERRUN: err=1; break; case CE_RXPARITY: err=2; break; default:break; } PostMessage(Parent,WM_COMM_ERR,(WPARAM)0,(LPARAM)err); break; case EV_BREAK: PostMessage(Parent,WM_COMM_BREAK,0,0); break; case ...://其他用SetCommMask()函数设置的被监视的串口通信事件。 ... ... break; default:break; } } 12-以上简要介绍了大部分的串口通信api函数，笔者所写的串口通信软件用的是事件通知方式，该方式是 windows2000下效率较高的一种方式。而且只熟悉这些api函数也还是不够的，该机制下还要牵涉到多 线程和消息机制，其中读写串口的动作是由主线程来完成的，比如说操作者按下发送数据的按钮之后 ，相应函数马上将某特定区域里面的数据发送出去，所以说用api函数写串口发送数据的功能是相对较 简单的。收数据的时候就要麻烦一点，在打开串口后首先主线程要设置要监视的串口通信事件，然后 将监视线程打开，用来监视主线程设置的这些串口通信事件是否已发生，当其中的某个事件发生后， 监视线程马上将该消息发送给主线程，其中监视线程在发送消息之前要确保主线程在收到消息后肯定 的知道串口究竟发生了什么样的事件，然后根据不同的事件类型进行处理。下面给出大致的主线程和 监视线程的大致工作流程：
主线程打开(其实就是主窗体打开之后) | | V 打开串口(设置波特率、校验方式、数据位数、停止位数) | | V 设置监视线程需要监视的串口通信事件 | | V 打开监视线程 | | V 等待各种事件的发生(比如发送数据单击事件，更改通信参数事件，监视线程发来的消息等) -------------------------------------------------------------------------------- 监视线程被打开 | | V 串口事件发生否(WaitCommEvent())(无论发生否均进入下面的代码) | | V 异步操作是否正在后台进行？(if(GetLastError()==ERROR_IO_PENDING)) | | V 在此等待异步操作结果(GetOverlappedResult(hComm,&os,&dwTrans,true)) | | V 处理通信事件，根据事件类型的不同给主窗体发送不同的消息