串口编程之一: WIN32 API 中串口DCB 结构的介绍

在应用WIN32  API 对串口进行编程时, 必定会使用到DCB 结构. 下面的DCB 结构的一些介绍. 

首先是DCB 结构. 

typedef  struct  _DCB {   
        DWORD DCBlength;           
        DWORD BaudRate;            
        DWORD fBinary:  1 ;          
        DWORD fParity:  1 ;          
        DWORD fOutxCtsFlow: 1 ;      
        DWORD fOutxDsrFlow: 1 ;      
        DWORD fDtrControl: 2 ;       
        DWORD fDsrSensitivity: 1 ;  
        DWORD fTXContinueOnXoff: 1 ; 
        DWORD fOutX:  1 ;            
        DWORD fInX:  1 ;             
        DWORD fErrorChar:  1 ;       
        DWORD fNull:  1 ;            
        DWORD fRtsControl: 2 ;       
        DWORD fAbortOnError: 1 ;     
        DWORD fDummy2: 17 ;         
        WORD wReserved;                     
        WORD XonLim;                 
        WORD XoffLim;                
        BYTE ByteSize;               
        BYTE Parity;                 
        BYTE StopBits;               
         char  XonChar;                
         char  XoffChar;               
         char  ErrorChar;              
         char  EofChar;                
         char  EvtChar;                
        WORD wReserved1;         
    } DCB; 

在这个结构中, 共有28个变量, 我把这些成员归类为几种. 
1.  串口的基本设置
     1) DWORD BaudRate;                      波特率设置。 
     2) BYTE ByteSize;                             数据位设置。
     3) DWORD fParity: 1;                       TRUE时， 支持奇偶检验。
     4) BYTE Parity;                                 奇偶检验位的设置
     5) BYTE StopBits;                             停止位的设置
2. 流控制(Flow Control) 的设置
     流控制分为硬件流控制和软件流控制。 而硬件流控制又分为RTS/CTS和DTR/DSR两种。而软件流控制， 则是Xon/Xoff。 
     DTR/DSR 硬件流控制：
     1) DWORD fOutxDsrFlow:1;            TRUE时，支持DSR流控制。 当DSR为OFF时，停止发送。 
     2) DWORD fDtrControl:2;                DTR设置。 （置高/置低...)   
     3) DWORD fDsrSensitivity:1;           TRUE时，当DSR为OFF，则接收端忽略所有字符。  

     RTS/CTS 硬件流控制：
     4) DWORD fOutxCtsFlow:1;            TRUE时，支持CTS流控制。 当CTS为OFF时，停止发送。
     5) DWORD fRtsControl:2;               RTS设置。 （置高/置低...)   

     Xon/Xoff 软件流控制：
     6) DWORD fOutX: 1;                       发送端支持Xon/Xoff。 
     7) DWORD fInX: 1;                         接收端支持Xon/Xoff。 
     8) WORD XonLim;                          当接收Buffer中的字符减少小XonLim规定的字符数， 就发送Xon字符，让对方继续发送。
     9) WORD XoffLim;                          接收Buffer达到XoffLim规定的字符数， 就发送Xoff字符， 让对方停止发送。
     10)char XonChar;                          Xon 字符。 
     11)char XoffChar;                          Xoff 字符。
     12)DWORD fTXContinueOnXoff:1; TRUE时，不管接收端是否Xoff， 本方发送端持续发送。 （也就是本方的发送端， 与本方接收端Xon/Xoff是相互独立的）。若为False 时，则当接收端buffer 达到XoffLim时，发送端发送完Xoff字符后，就停止发送。 
                   
3.  Error 情况处理
     1) DWORD fErrorChar: 1;              TRUE时，若fParity为TRUE， 则用ErrorChar替换Parity Check错误的字符。 
     2) DWORD fAbortOnError:1;          TRUE时，发生错误时停止读写操作。
     3) char ErrorChar;                         Parity Check 错误时，替换的字符。 
         
4. 其他参数
     1) DWORD DCBlength;                  DCB结构的长度（以字节为单位）
     2) DWORD fBinary: 1;                   二进制模式。(必须为1 )
     3) DWORD fNull: 1;                       TRUE时，接收时去掉空字节（0x0)
     4) char EofChar;                           EOF替代字符
     5) char EvtChar;                           事件触发字符
     6) DWORD fDummy2:17;              保留
     7) WORD wReserved;                  保留
     8) WORD wReserved1;                 保留