WinCE串口编程API函数(二)

异步串口I/O：

　　BOOL GetCommMask(

　　HANDLE hFile,

　　LPDWORD lpEvtMask

　　);

　　BOOL SetCommMask(

　　HANDLE hFile,

　　DWORD dwEvtMask

　　);

　　BOOL WaitCommEvent(

　　HANDLE hFile,

　　LPDWORD lpEvtMask,

　　LPOVERLAPPED lpOverlapped

　　);

　　GetCommMask函数用于得到串口已经设置了的串口事件，参数hFile指定已打开的串口句柄，参数lpEvtMask用于存取得到的串口事件集。SetCommMask函数的功能与GetCommMask函数正好相反，用于设置串口事件集。WaitCommEvent函数用于等待预先设置的串口事件中的某一个事件发生，该函数将阻塞线程，直到预先设置的串口事件中的某一事件的发生。参数lpEvtMask用于存储已经发生的事件，参数lpOverlapped必须设置为NULL，因为在Windows CE中不支持重叠I/O操作。

　　串口时间表： EV_BREAK 检测到中断发生 EV_CTS CTS信号改变了状态 EV_DSR DSR信号改变了状态 EV_ERR 串口驱动程序检测到了错误，如CE_RXPARITY，CE_OVERRUN,CE_FRAME EV_RING 检测到振铃 EV_RLSD RLSD信号改变了状态 EV_RXCHAR 接收到了一个字符 EV_RXFLAG 接收到了一个事件字符 EV_TXEMPTY 在输出缓冲区中的最后一个字符被发送 .设置端口读写超时：

　　BOOL GetCommTimeouts(

　　HANDLE hFile,

　　LPCOMMTIMEOUTS lpCommTimeouts

　　);

　　BOOL SetCommTimeouts(

　　HANDLE hFile,

　　LPCOMMTIMEOUTS lpCommTimeouts

　　);

　　在用ReadFile和WriteFile读写串口时，需要考虑超时问题。如果在指定的时间内没有读出或者写入指定数量的字节数据，那么ReadFile函数或者WriteFile函数就会返回。GetCommTimeouts函数用来查询当前的超时时间设置，该函数会填充一个COMMTIMEOUTS结构。SetCommTimeouts函数用来通过一个COMMTIMEOUTS结构设置超时时间。两个函数的返回值都是成功时返回非零值，失败时返回零。

　　typedefstruct _COMMTIMEOUTS {

　　DWORD ReadIntervalTimeout; /*读间隔超时*/

　　DWORD ReadTotalTimeoutMultiplier; /*读时间系数*/

　　DWORD ReadTotalTimeoutConstant; /*读时间常量*/

　　DWORD WriteTotalTimeoutMultiplier; /*写时间系数*/

　　DWORD WriteTotalTimeoutConstant; /*写时间常量*/

　　} COMMTIMEOUTS,*LPCOMMTIMEOUTS;

　　ReadIntervalTimeout：以毫秒为单位设置通信线路上的两个字符到达之间最大时间间隔。在ReadFile操作期间，从接收到第一个字符开始计时。如果任意两个字符到达之间的时间间隔超过这个最大值，则ReadFile操作完成，返回缓冲数据。如果该值设置为0，则不使用间隔超时。

　　ReadTotalTimeoutMultiplier：读时间系数。以毫秒为单位设置一个用来计算读操作总超时时间的时间系数。

　　ReadTotalTimeoutConstant：读时间常量。以毫秒为单位设置一个用来计算读操作总超时时间的时间常量。

　　读总超时时间 = 读时间系数*要读的字节数 + 读时间常量

　　WriteTotalTimeoutMultiplier：写时间系数。以毫秒为单位设置一个用来计算写操作总超时时间的时间系数。

　　WriteTotalTimeoutConstant：写时间常量。以毫秒为单位设置一个用来计算写操作总超时时间的时间常量。

　　写总超时时间 = 写时间系数*要写的字节数 + 写时间常量

　　超时有间隔超时和总超时两种类型。间隔超时是指在接收时两个字符之间的最大时延。从串口读取数据时，当接收到一个字节时，通信驱动程序启动一个内部定时器开始计时，在下一个字节到来之前，如果定时器时间超过了间隔超时时间，读操作就会被放弃。总超时是指读操作或者写操作总共花费的最大时间。写操作只支持总超时，读操作对两种类型的超时都支持。

　　如果应用程序将ReadIntervalTimeout和ReadTotalTimeoutMultiplier设置为MAXDWORD，并且将ReadTotalTimeoutConstant设置为大于0并且小于MAXDWORD的数，则调用ReadFile函数时，会有以下情况：

　　1 如果接收缓冲区中有字符存在，则ReadFile函数立即返回这些字符。

　　2 如果接收缓冲区中没有字符，则ReadFile函数会等待直到一个字符到达，然后立即返回。

　　3 若在ReadTotalTimeoutConstant设定的时间内没有任何字符到达，则ReadFile超时返回。

　　间隔超时和总超时的设置是不相关的。

　　下面列举一些情况：

　　1 有读间隔超时，读总超时，写总超时：将COMMTIMEOUTS结构中的五个成员设置为相应值。

　　2 有读总超时，写总超时：将ReadIntervalTimeout设置为0，将其他成员设置为相应值。

　　3 在读一次输入缓冲区中的内容后，读操作就立即完成，不管是否读入了要求的字符：将ReadIntervalTimeout设置为MAXDWORD，

　　将ReadTotalTimeoutMultiplier和ReadTotalTimeoutConstant都设置为0。

　　4 ReadFile没有超时设置，直到有适当的字符数返回或者错误发生，该函数才返回：将ReadIntervalTimeout，ReadTotalTimeoutMultiplier和

　　ReadTotalTimeoutConstant都设置为0。

　　5 WriteFile没有超时设置：将WriteTotalTimeoutMultiplier和

　　WriteTotalTimeoutConstant都设置为0。

　　例：

　　----------------------------------

　　COMMTIMEOUTS CommTimeOuts;

　　GetCommTimeouts(m_hComm, &CommTimeOuts);

　　CommTimeOuts.ReadIntervalTimeout = 100;/* 接收字符间最大时间间隔 */

　　CommTimeOuts.ReadTotalTimeoutMultiplier = 1;

　　CommTimeOuts.ReadTotalTimeoutConstant = 100;/* 读数据总超时常量 */
CommTimeOuts.WriteTotalTimeoutMultiplier = 0;

　　CommTimeOuts.WriteTotalTimeoutConstant = 0;

　　SetCommTimeouts(m_hComm, &CommTimeOuts);

　　----------------------------------

　　----------------------------------

　　COMMTIMEOUTS CommTimeOuts;

　　GetCommTimeouts (m_hComm, &CommTimeOuts);

　　CommTimeOuts.ReadIntervalTimeout = MAXDWORD;

　　CommTimeOuts.ReadTotalTimeoutMultiplier = 0;

　　CommTimeOuts.ReadTotalTimeoutConstant = 0;

　　CommTimeOuts.WriteTotalTimeoutMultiplier = 10;

　　CommTimeOuts.WriteTotalTimeoutConstant = 1000;

　　SetCommTimeouts( m_hComm, &CommTimeOuts )