串口通信中ReadFile和WriteFile的超时详解!

时间:2023-03-10 08:23:54
串口通信中ReadFile和WriteFile的超时详解!

源:串口通信中ReadFile和WriteFile的超时详解!

在用ReadFile和WriteFile读写串行口时,需要考虑超时问题。如果在指定的时间内没有读出或写入指定数量的字符,那么ReadFile或WriteFile的操作就会结束。要查询当前的超时设置应调用GetCommTimeouts函数,该函数会填充一个COMMTIMEOUTS结构。调用SetCommTimeouts可以用某一个COMMTIMEOUTS结构的内容来设置超时。 有两种超时:间隔超时和总超时。间隔超时是指在接收时两个字符之间的最大时延,总超时是指读写操作总共花费的最大时间。写操作只支持总超时,而读操作两种超时均支持。

  用COMMTIMEOUTS结构可以规定读/写操作的超时,该结构的定义为:
typedef struct _COMMTIMEOUTS {
  DWORD ReadIntervalTimeout; // 读间隔超时。 接收时,两字符间最大的时延。
  DWORD ReadTotalTimeoutMultiplier; // 读时间系数。 读取每字节的超时。
  DWORD ReadTotalTimeoutConstant; // 读时间常量。 读串口数据的固定超时。
// 总超时 = ReadTotalTimeoutMultiplier * 字节数 + ReadTotalTimeoutConstant
  DWORD WriteTotalTimeoutMultiplier;// 写时间系数。 写每字节的超时。
  DWORD WriteTotalTimeoutConstant; // 写时间常量。 写串口数据的固定超时。
// 总超时 = WriteTotalTimeoutMultiplier * 字节数 + WriteTotalTimeoutConstant
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;
COMMTIMEOUTS//COMMTIMEOUTS对象
SetCommTimeouts(handlePort_,&comTimeOut);//;将超时参数写入设备控制

ReadIntervalTimeout:

  指定通讯线上两个字符到达的最大时延,以毫秒为单位。在ReadFile操作期间,时间周期从第一个字符接收到算起。如果收到的两个字符之间的间隔超过该值,ReadFile操作完毕并返回所有缓冲数据。如果ReadIntervalTimeout为0,则该值不起作用。

  如果值为MAXDWORD,   并且ReadTotalTimeoutConstant和ReadTotalTimeoutMultiplier两个值都为0,   则指定读操作携带已经收到的字符立即返回,即使没有收到任何字符。

ReadTotalTimeoutMultiplier:

  指定以毫秒为单位的累积值。用于计算读操作时的超时总数。对于每次读操作,该值与所要读的字节数相乘。

ReadTotalTimeoutConstant : 

  指定以毫秒为单位的常数。用于计算读操作时的超时总数。对于每次读操作,ReadTotalTimeoutMultiplier与所要读的字节数相乘后与该值相加。

如果ReadTotalTimeoutMultiplier和ReadTotalTimeoutConstant都为0,则在读操作时忽略总超时数。

WriteTotalTimeoutMultiplier:

  指定以毫秒为单位的累积值。用于计算写操作时的超时总数。对于每次写操作,该值与所要写的字节数相乘。

WriteTotalTimeoutConstant:

  指定以毫秒为单位的常数。用于计算写操作时的超时总数。对于每次写操作,WriteTotalTimeoutMultiplier与所要写的字节数相乘后与该值相加。

如果WriteTotalTimeoutMultiplier和WriteTotalTimeoutConstant都为0,则在写操作时忽略总超时数。

提示:用户设置通讯超时后,如没有出错,串口已经被打开。

  COMMTIMEOUTS结构的成员都以毫秒为单位。   

  总超时的计算公式是:   

  总超时 = 时间系数 × 要求读/写的字符数 + 时间常量   

  例如,如果要读入10个字符,那么读操作的总超时的计算公式为:   

  读总超时 = ReadTotalTimeoutMultiplier × 10 + ReadTotalTimeoutConstant   

  可以看出,间隔超时和总超时的设置是不相关的,这可以方便通信程序灵活地设置各种超时。如果所有写超时参数均为0,那么就不使用写超时。如果ReadIntervalTimeout为0,那么就不使用读间隔超时,如果ReadTotalTimeoutMultiplier和ReadTotalTimeoutConstant都为0,则不使用读总超时。如果读间隔超时被设置成MAXDWORD并且两个读总超时为0,那么在读一次输入缓冲区中的内容后读操作就立即完成,而不管是否读入了要求的字符。 在用重叠方式读写串行口时,虽然ReadFile和WriteFile在完成操作以前就可能返回,但超时仍然是起作用的。在这种情况下,超时规定的是操作的完成时间,而不是ReadFile和WriteFile的返回时间。