ClearCommError()函数

ClearCommError()函数

清除串行端口错误或读取串行端口现在的状态时，可用函数ClearCommError。Windows系统利用此函数清除硬件的通讯错误以及获取通讯设备的当前状态

ClearCommError()函数原型

1 2 3 4 5

BOOL ClearCommError(                     HANDLE hFile,   //通信设备的句柄                     LPDWORD lpErrors,//接收错误代码变量的指针                     LPCOMSTAT lpStat  //通信状态缓冲区的指针 );

ClearCommError()函数参数说明：

• hFile：串行端冂的Handle值，此值即为使用CreateFile函数后所返回的值。
• lpError：返回错误数值，错误常数如下：
  CE_BREAK：检测到中断信号。
  CE_DNS：Windows95专用，未被选择的并行端口。
  CE_FRAME：硬件检到框架错误
  CE_IOE：通信设备发生输入／输出綹误，
  CE_MODE：设置模式错误，或是hFile值错误。
  CE_OOP：Wmdows95专用，并行端口发生缺纸错误。CE_OVERRUN：缓冲区容量不足，数据将遗失。
  CE_PTO：Windows95专用，并行端口发生超时错误。
  CE_RXOVER：接收区满溢或在文件结尾被接收到后仍有数据发送过来。
  CE_RXPARITY：硬件检测到校验位检查错误。
  CE_TXFULL：发送缓存区已满后，应用程序仍要发送数据。
• lpStat:指向通信端口状态的结构变量。此结构的原始声明如下：
  _COMSTAT结构定义

  C

  1 2 3 4 5 6 7 8 9 10 11 12

  typedef struct _COMSTAT {  //cst     DWORD fCtsHold : 1;  //Tx正在等待CTS信号       DWORD fDsrHold : 1;  //Tx正在等待DSR信号     DWORD fRlsdHold : 1; //Tx正在等待RLSD信号     DWORD fXoffHold : 1;  //Tx由于接收XOFF字符而在等待     DWORD fXoffSent : 1;   //Tx由于发送XOFF字符而在等待     DWORD fEof : 1;      //发送EOF字符     DWORD fTxim : 1;     //字符在等待Tx     DWORD fReserved : 25;   //保留     DWORD cbInQue;    //输入缓冲区中的字节数     DWORD cbOutQue;     //输出缓冲区中的字节数 } COMSTAT, *LPCOMSTAT;

  
  此结构屮有关参数说明如下：
  fCtsHold：是否正在等待CTS信号。占一个位的位置。
  fDsrHold：是否正在等待DSR信号。占一个位的位置。
  fRlsdHoId：是否正在等待RLSD信号。占一个位的位置。
  fXoftHoId：是否因收到xoff字符而在等待。占一个位的位置。
  fXoffHold：是否因送出xoff字符而使得发送的动作在等待。占一个位置
  cbInQue：在输入缓冲区尚未被ReadFile函数读取的数据字节数。这个参数经常被用来进行状态检查。
  cbOutQue：在发送缓冲区而尚未被发送的据字节数。

相关文章:

1. GetCommState()函数

   GetCommState()函数功能，使用指定通信设备的当前控制设置填充设备控制块（DCB结构）...

2. SetCommState()函数

   SetCommState()函数设置串行端口状态。如设置串口设置(波特率,校验,停止位,数据位等)....

3. WriteFile()函数

   windows将串行端口当成文件来使用，因此写入串行端口数据的函数也是WriteFile。...

4. ReadFile()函数

   windows将串行端口的使用当成文件，因此读取串行端口数据的函数亦使用读文件函数ReadFile....

5. checkradiobutton()函数

       函数功能：该函数给一组单选按钮中的一个指定按钮加上选中标志，并且清除组中其他按钮的选中标志。函数原型：BOOL CheckRadioButtoh（HWNDhDlg， intnlDFirstButton， intnlDLastBUtton， intnlDCheckButton）；...

6. setcaretpos()函数

       函数功能：该函数将插入标记移动到指定的坐标上。如果拥有该插人标记的窗口是使用CS_OWNDC类样式创建的，那么指定的坐标依据与该窗口相关的设备环境的映射模式而定。函数原型：BOOL SetCaretPos（int X，int Y）；...

7. dlgdirselectex()函数

       函数功能：该函数从单选列表框中检取当前选择，列表框已经由DlgDirlist函数填充，并且选择内容为一个驱动器字母，文件名或目录名。函数原型：BOOL DlgDirSelectEx（HWND hDlg，LPTSTR lpString，int nCount，int nlDListBox）；...

8. pagesetupdlg

      函数功能：该函数创建一个PageSetup对话框，此对话框能使用户指定打印页的属性。这些属性包括纸张大小和来源，送纸方向和页边距。函数原型：BOOL PageSetupDlg（LPPAGESETUPDLGI ppsd）；...

9. frhookproc()函数

       函数功能：该函数是由应用程序定义或库定义的回调函数。它和FindText函数或Replace Text函数一定使用。挂钩函数接收用于Find或Replace公共对话框的缺省对话框函数的消息和通告。LPFRHOOKPROC类型定义了一个指向此回调函数的指针，FRHookProc是一个应用程序定义的函数名的位置持有者。数原型：UINT CALLBACK FRHookProc（HWND hdlg，UINT uiMsg WPARAM wParam，LPARAM IParam）；...

10. LoadCursorFromFile()函数

    函数功能：该函数根据一个文件中所含的数据创建光标。该文件由它的名字所指定或由一个系统光标鉴别器指定，该函数返回一个新建光标的句柄，文件所包含的光标数据可以是光标格式（CUR）或运动光标格式（.ANI）。函数原型：HCURSOR LoadCursorFromFile（LPCTSTR IpFileName）；...