利用Windows应用程序编程接口为程序提供串口通信功能

    1.串行编程的数据结构:DCB(Device Control Block)、CIMMTIMEOUTS

    DCB:设备控制块
通过该数据结构，完成对串口端的初始化工作   该数据结构包含了  传输波特率、数据位数、奇偶检验类型和停止位数等参数
在查询或者配置串行端口的属性时，需要使用DCB数据结构作为缓冲区

    Win32 API
USER32.DLL      负责窗口管理，包括消息、菜单、光标、通信、计时器和其它与控制窗口显示
GDI32.DLL        提供图形设备接口、管理用户界面和图形绘制，包括Windows元文件、位图、设备描述符和字体等
KERNEL32.DLL    处理存储器底层功能、任务和资源管理等windows核心服务

Win16:
打开和关闭串口
OpenComm() 打开串口资源，并指定输入、输出缓冲区的大小
CloseComm() 关闭串口

            int idComDev;
idComDev = OpenComm("COM1",1024,128);
CloseComm(idComDev);

    2.初始化串口，设置串口参数
BuildCommDCB()、SetCommState()填写设备控制块DCB  然后对已打开的串口进行参数配置

DCB dcb;
BuildCommDCB("COM1:2400,n,8,1",&dcb);
SetCommState(&dcb);
3.读写串口，收发数据
ReadComm、WriteComm 对串口进行读写操作  数据的接收和发送

            char *m_pReceive;
int count;
ReadComm(idComDev,m_pReceive,count);
char wr[30];
int count2;
WriteComm(idComDev,wr,count2);

    16位下的串口等外部设备操作 有自己特有的API函数  而32位程序则把串口操作(以及并口)和文件系统操作关联在了一起

串口编程中常用到的结构及相关的概念

    1. DCB(Device Control Block) 结构
GetCommState()可以用来获得串口的配置  
将当前配置填充到一个DCB结构中    
在用CreateFile 打开串行口后，可以调用GetCommState函数来获取串行口的初始配置
然后修改DCB结构  再调用SetCommState函数用指定的DCB结构来设置串行口

            typedef struct _DCB {
DWORD DCBlength;      /* DCB结构大小                     */
DWORD BaudRate;       /* 当前波特率                      */
DWORD fBinary: 1;     /* 二进制模式，不检测EOF           */
DWORD fParity: 1;     /* 允许奇偶校验                    */
DWORD fOutxCtsFlow:1; /* CTS 输出流控制                  */
DWORD fOutxDsrFlow:1; /* DSR 输出流控制                  */
DWORD fDtrControl:2;  /* DTR 流控制类型                  */
DWORD fDsrSensitivity:1; /* DSR 信号线是否敏感           */
DWORD fTXContinueOnXoff: 1; /* XOFF continues Tx         */
DWORD fOutX: 1;       /* XON/XOFF 输出流控制             */
DWORD fInX: 1;        /* XON/XOFF 输入流控制             */
DWORD fErrorChar: 1;  /* 允许错误替换                    */
DWORD fNull: 1;       /* 允许剥离去掉NULL字符            */
DWORD fRtsControl:2;  /* Rts 流控制                      */
DWORD fAbortOnError:1; /* 有错误是终止读/写操作          */
DWORD fDummy2:17;     /* 保留                            */
WORD wReserved;       /* 当前不用                        */
WORD XonLim;          /* XON发送字符之前缓冲区中允许接收最小字节数         */
WORD XoffLim;         /* XON发送字符之前缓冲区中允许接收最小可用字节数         */
BYTE ByteSize;        /* 数据位数                        */
BYTE Parity;          /* 奇偶校验0-4 表示:不校验 奇校验 偶校验 标号 空格   */
BYTE StopBits;        /* 停止位 0,1,2 = 1, 1.5, 2               */
char XonChar;         /* 发送和接收的 XON 字符           */
char XoffChar;        /* 发送和接收的 XOFF 字符          */
char ErrorChar;       /* 替换接收到的奇偶校验发生错误的字符         */
char EofChar;         /* 输入数据结束字符                */
char EvtChar;         /* 接收到的事件字符                */
WORD wReserved1;      /* 保留位 不用                     */
} DCB, *LPDCB;

    DCB 结构参数说明
DCBlength：
以字节为单位设置DCB结构长度大小

        BaudRate：
设置波特率(串口传输速率) 可以以实际数据表示  如9600等
或 CBR_110 CBR_300 CBR_1200 CBR_2400 CBR_4800 CBR_9600 CBR_14400 CBR_19200等

        fBinary：
是否允许二进制传输 Win32API 不支持非二进制方式传输  因此 该参数必须设置为TRUE

        fParity：
是否允许奇偶校验 如果设置为TRUE 则进行就校验并报告错误信息

        fOutxCtsFlow：
指定CTS(clear-to-send)信号是否检测输出流控制 该值为TRUE且CTS为off时，发送被暂停 直至CTS被重新置为on

        fOutxDsrFlow：
指定DSR(data-set-ready)信号是否检测输出流控制 该值为TRUE且DSR为off时，发送被暂停 直至DSR被重新置为on

        fDtrControl：
设置DTR(data-terminal-ready)流控制
DTR_CONTROL_DISABLE 当串口被打开时  禁止DTR线 并保持禁止状态
DTR_CONTROL_ENABLE  当串口被打开时 允许DTR线 并保持允许状态
DTR_CONTROL_HANDSHAKE 允许DTR握手  如果handshaking被打开  不允许使用EscapeCommFunction函数 调整线路状态

        fDsrSensitivity:
设置通信驱动程序对DTR信号是否敏感 如果该值为TRUE 且DSR信号线为低(OFF)时 接收的任何字节将被忽略

        fTXContinueOnXoff:
设置当接收缓冲区已满 且驱动程序已发送出XoffChar字符时  发送是否停止
若该值为TRUE 在接收缓冲区接收到了缓冲区已满的字节XoffLim，且驱动程序已经发送出XoffChar字符去停止接收
字节后发  送继续进行
若该值为FALSE 当接收缓冲区接收到代表缓冲区已空的字节数XonLim，且驱动程序已发送出恢复发送XonChar字符
后 发送可以继续进行

        fOutX:
设置发送时是否使用XON/XOFF流控制 当该值为TRUE时 收到XoffChar字符后发送停止  只有再接收到XonChar字符后才能
继续发送

        fInX:
设置在接收时是否应用XON/XOFF流控制  
当该值为TRUE时  接收缓冲区收到代表接收缓冲区已满XoffLim字节数后  XoffChar 被发送出去
接收缓冲区收到代表缓冲区已空的XonLim字节数后  XonChar 字符被发送出去

        fErrorChar:
设置是否使用ErrorChar成员指定的错误替换字符来替换当奇偶检验出错时的接收字符 该项选择只有在fParity为TRUE有效

        fNull:
设置是否剥离丢掉接收到的NULL字符(ASCII值为0) 该值为TRUE时  NULL字符被丢掉 否则保留

        fRtsControl:
设置RTS(request-to-send)流控制 缺省值为RTS_CONTROL_HADNSHAKE
RTS_CONTROL_DISABLE   当串口被打开时 禁止RTS线 并保持禁止状态
RTS_CONTROL_ENABLE    当串口被打开时 允许RTS线 并保持允许状态
RTS_CONTROL_HANDSHAKE 允许RTS握手   当接收缓冲区中字节数小于缓冲区最大值的1/2时 将RTS线置为ON
当接收缓冲区中字节数大于缓冲区最大值的3/4时 将RTS线置为OFF
RTS_CONTROL_TOGGLE    当还有等待发送的字节时  将RTS线置高  全部发送完后  将RTS线置为低

        fAbortOnError:
当有错误产生  设置是否终止读写操作  当该值为TRUE 驱动程序将终止读写操作
只有程序调用ClearCommError函数处理错误后  通信才能恢复

        fDummy2:
保留
wReserved：
当前不用 必须设置为 0

        XonLim:
设置在XON字符发送之前输入(接收)缓冲区中允许最小字节数

        XoffLim:
设置在发送XOFF字符之前 (接收)缓冲区中允许最大的字节数  醉倒字节数为接收缓冲区大小减去本值

        ByteSize
设置数据位  字节表示4-8位

        Parity:
设置奇偶校验方式
EVENPARITY:  EVEN  偶校验
MARKPARITY： MARK  标号校验
NOPARITY  :  No Parity 无校验
ODDPARITY ： ODD    奇校验
SPACEPARITY：SPACE 空格校验

        StopBits 
设置停止位
ONESTOPBIT
ONE5STOPBITS
TWOSTOPBITS

        XonChar
设置发送和接收的XON字符

        XoffChar
设置和发送接收XOFF字符

        ErrorChar
设置用来替换接收到的奇偶校验发生错误的字符

        EofChar
设置事件字符  当接收到次字符时  会产生一个事件

        wReserved1
保留位  不用

    2. 超时设置 COMMTIMEOUTS结构
在指定的时间内没有读出或写入指定数量的字节 那么ReadFile或WriteFile的操作就会结束
要查询当前的超时设置应当调用GetCommTimeouts函数

        typedef struct _COMMTIMEOUTS {
DWORD ReadIntervalTimeout;          /* 读间隔超时  */
DWORD ReadTotalTimeoutMultiplier;   /* 读时间系数  */
DWORD ReadTotalTimeoutConstant;     /* 读时间常量  */
DWORD WriteTotalTimeoutMultiplier;  /* 写时间系数  */
DWORD WriteTotalTimeoutConstant;    /* 写时间常量  */
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;

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

            ReadTotalTimeoutMultiplier:读时间系数
以毫秒为单位设置一个用来计算读操作总超时时间的时间系数 
读时间系数乘以要求读出的字节数

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

            WriteTotalTimeoutMultiplier: 写时间系数
以毫秒为单位设置一个用来计算写操作总超时时间的时间系数 
读时间系数乘以要求写入的字节数

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

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

    3. OVERLAPPED 异步I/O 重叠结构
在用ReadFile和WriteFile读写串口数据时 既可以同步执行 也可以重叠(异步)执行

        同步执行:函数直到操作完成后才返回   在同步执行时  线程会被阻塞 导致效率下降
重叠执行:即使操作还未完成，调用函数也会立即返回  费时的I/O操作在后台进行 此时线程可以干其他的事情

        在异步操作时 会用到OVERLAPPED异步I/O结构
typedef struct _OVERLAPPED {
DWORD Internal;        // 保留给系统内部使用
DWORD InternalHigh;    // 保留给系统内部使用
DWORD Offset;          // 指定开始传输数据的位置
DWORD OffsetHigh;      // 定义offset值的高字节
HANDLE  hEvent;        // 当数据传输完成时 设置的事件句柄
} OVERLAPPED, *LPOVERLAPPED;

        在串口通信过程中 与重叠I/O操作关系最密切的是串口的读写操作  涉及到的函数ReadFile和WriteFile 当这两个函数返回FALSE
可以调用GetLastError函数分析返回的结果

        如果操作还未完成函数就返回 那么函数就返回FALSE 而且GetLastError函数返回 ERROR_IO_PENDING

        在使用重叠I/O时 线程需要创建OVERLAPPED结构以供读写函数使用  OVERLAPPED结构最重要的成员是hEvent hEvent是一个事件对象
句柄  线程应该使用CreateEvent函数为hEvent成员创建一个手工重置事件 hEvent成员将作为线程的同步对象使用

如果读写函数为完成操作就返回 那么就把hEvent成员设置成无信号的
操作完成后 hEvent就会变为有信号的

        异步I/O操作有两种办法获取结果
GetOverlappedResult
WaitForSingleObject等待事件处理函数

    通信错误与通信设备状态
在串口通信过程中  如果遇到奇偶校验、终端错误.I/O操作就会终止 
此时如果要进一步进行I/O操作 则必须调用ClearCommError 函数来清除错误标志

        错误类型:
CE_BREAK                硬件检测到一个中断条件
CE_DNS                    win9x:一个并行设备没有被选择
CE_FRAME                硬件检测到一个帧错误
CE_IOE                    发生一个I/O操作错误
CE_MODE                    设置通信模式出错 或者句柄无效
CE_OOP                    win9x:并行设备缺纸
CE_OVERRUN                超速错误  下一个字符丢失’
CE_PTO                    win9x:并行设备发生超时错误
CE_RXOVER               接收缓冲区溢出错误 缓冲区满  或者接收到文件结束字符(EOF)后还收到了字符
CE_RXPARITY                硬件检测到一个奇偶校验错误
CE_TXFULL                发送缓冲区满  应用程序无法再发送数据

Windows API串行通信函数
CreateFile            打开串口
SetupComm             缓冲区分配
GetCommState          获取串口当前配置
SetCommState          配置串口
GetCommProperties    获取串口属性
BuildCommDCB         DCB填充
BuildCommDCBAndTimeouts  DCB和Timeouts填充
GetCommTimeouts     超时获取
SetCommTimeouts     超时设置
ReadFile/ReadFileEx 读串口
WriteFile/WriteFileEx 写串口
ClearCommError         清除错误标志
PurgeComm            终止读写/清空缓冲区
FlushFileBuffer     清空缓冲区
GetOverlappedResult 异步I/O操作结果获取
WaitForSingleObject 异步I/O操作事件获取
SetCommMask         通信事件设置
GetCommMask         通信事件获取
WaitCommEvent       通信事件检测
CreateEvent          事件创建
EscapeCommFunction     握手信号设置
SetCommBreak        通信设备挂起
ClearCommBreak        通信设备恢复

Win32串口通信编程的一般流程
打开串口                           CreateFile
建立串口通信事件                  CreateEvent
初始化串口，设置串口参数        SetCommState
建立读数据的线程                
写数据                            WriteFile
结束时关闭端口                    若程序打开了其它线程 则线终止线程 停止WaitCommEvent的等待以及关闭端口CloseHandle

ClearCommError 清除错误标志函数
在调用ReadFile和WriteFile之前 应用程序应该调用ClearCommError函数清除错误标志 
该函数负责报告指定错误和设备的当前状态

    BOOL ClearCommError(
HANDLE hFile, //通信设备(串口)句柄 通过CreateFile返回值得到
LPDWORD lpErrors, // 错误掩类型
LPCOMSTAT lpStat // pointer to buffer for communications status
);

    lpErrors: 错误掩类型  常见错误类型上述表格
lpStat:指向一个COMSTAT结构 该结构可返回通信设备的状态信息

    若调用成功  返回非0值
不成功  则为0  错误时 调用GetLastError查看错误信息

    通过查询的方式读串口
得到缓冲区字节数 通过ClearCommError 的调用来确定接收缓冲区中等待读取的字节数
typedef struct _COMSTAT{
DWORD cbInQue; // byte in input buffer
DWORD cbOutQue; // byte in output buffer
}COMSTAT,*LPCOMSTAT;

PurgeComm() 清除函数  可以终止任何未决的后台读/写操作 并且可以冲掉缓冲区

COMMTIMEOUTS to;
DWORD ReadThread(LPDWORD lpdwParam){
BYTE inbuff[100];
DWORD nBytesRead;
if(!(cp.dwProvCapabilities & PCF_INITIMEOUTS))
return 1L;

    memset(&to,0,sizeof(to));
to.ReadIntervalTimeout = MAXDWORD;
SetCommTimeouts(hComm,&to);
while(bReading){
if(!ReadFile(hComm,inbuff,100,&nBytesRead,NULL))
locProcessCommError(GetLastError());
else if(nBytesRead)
locProcessBytes(inbuff,nBytesRead);
}

    PurgeComm(hComm,PURGE_RXCLEAR);
}

23个常用的串口函数介绍

    1.CreateFile 打开串口
HANDLE CreateFile(
LPCTSTR lpFileName,     // 文件名 "COM1"、"COM2"等
DWORD dwDesiredAccess,     // 访问模式 读、写或同时读写
DWORD dwShareMode,        // 共享模式，常为 0
LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 通常为NULL
DWORD dwCreationDistribution,    // 创建方式:OPEN_EXISTING
DWORD dwFlagAndAttributes,        // 文件属性和标志
HANDLE hTemplateFile        // 临时文件句柄  常为NULL
)

        功能:在Win32操作系统中 文件是一个广泛的概念 包含文件、通信设备、命名管道、邮件槽、磁盘、控制台等 都是使用
该函数打开或创建的

        返回值:
调用成功 返回值是一个文件句柄(long) 
调用失败 返回错误信息 INVALID_HANDLE_VALUE 同时设置GetLastError
即使成功 若文件存在且指定了 CREATE_ALWAYS或OPEN_ALWAYS,GetLastError也会设为ERROR_ALREADY_EXISTS

        参数说明:
lpFileName：String类型  设置要打开的文件名 串口的逻辑名   "COM1"、"COM2"
当串口号大于COM9时  串口的逻辑名为"\\\\.\\COMXX" COM10 ====> "\\\\.\\COM10"

            dwDesiredAccess：long 类型  设置串口访问模式
GENERIC_READ  表示允许对设备进行读访问  读串口
GENERIC_WRITE 表示允许对设备进行写访问  写串口
GENERIC_READ | GENERIC_WRITE 表示可同时读写  读写串口
0  只允许获取与一个设备有关的信息

            dwShareMode: long 类型 设置串共享属性
0   不共享
FILE_SHARED_READ 或 FILE_SHARED_WRITE 表示允许对文件进行共享访问
对于串口 不能设置成共享 因此必须设置为0
如果当前应用程序调用CreateFile来打开串口 串口不存在或者被其他设备占用(已经打开) 则返回错误信息

lpSecurityAttributes:指向一个SECURITY_ATTRIBUTES 指针 定义了文件的安全特性
对于串口 设置为NULL

            dwCreationDistribution: 类型为long 设置创建方式 
CREATE_NEW         : 创建文件 如果存在则出错
CREATE_ALWAYS     : 创建文件 会改写前一个文件
OPEN_EXISTING     : 文件必须已经存在 由设备提出要求
OPEN_ALWAYS     : 如果文件不存在 则创建它
TRUNCATE_EXISTING:将现有文件缩短为0
对于串口 因其总是存在的  故该值只能设置为OPEN_EXISTING

            dwFlagAndAttributes: 类型为long 设置文件的各种属性  可用一个或多个属性  例如:
标记为归档属性、默认属性、隐藏文件或目录、文件为只读、文件为系统文件、文件允许重叠操作等
FILE_ATTRIBUTE_XXX 等
FILE_FLAG_XXXX 等
对于串口  唯一有意义的设置 FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作

            hTemplateFile:类型为long  如果不为0 则指定一个文件句柄  新文件将从这个文件中复制扩展属性

        总结：在打开一个通信端口时 应该以独占的方式打开 另外要指定GENERIC_READ、GENERIC_WRITE、OPEN_EXISTING
FILE_ATTRIBUTE_NORMAL等 如果要打开重叠IO  就应该指定 FILE_FLAG_OVERLAPPED

        重叠IO:就是异步操作或非阻塞操作  即在执行一项操作时 若系统有别的操作请求 可以立即返回执行其他任务 这样程序就不会类似
"死机"

            打开串口的一般操作:
HANDLE hComm = CreateFile(
"COM1",
GENERIC_READ | GENERIC_WRITE,
0,
NULL,
OPEN_EXISTING,
FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED,    //重叠I/O
NULL
);
if(hComm == INVALID_HANDLE_VALUE)
{
GetLastError();
}

    2.SetupComm 缓冲区分配函数

        BOOL SetupComm(
HANDLE hFile,    // 通信设备(串口)句柄 通过CreateFile返回值得到
DWORD dwInQueue, // 输入缓冲区大小
DWORD dwOutQueue // 输出缓冲区大小
);

        返回值:
调用成功 返回0值
不成功 则为0 有错误时 可调用GetLastError 函数得到错误信息

        说明:
串口打开后 就可以使用SetupComm为其设置缓冲区大小  若不设置 则系统自动将其设置成缺省大小
设置时应该避免缓冲区溢出  比实际大小稍大一点

    3.GetCommState 获取串口当前配置函数

        BOOL GetCommState(
HANDLE hFile, // 通信设备(串口)句柄 通过CreateFile返回值得到
LPDCB lpDCB   // 指向DCB (device-control block) 结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

    4.SetCommState 配置串参数
BOOL SetCommState(
HANDLE hFile, // 通信设备(串口)句柄 通过CreateFile返回值得到
LPDCB lpDCB   // 指向DCB (device-control block) 结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

        说明:SetCommState函数通过DCB结构来定义串口配置 当前的串口配置由GetCommState函数得到
在设置过程中 有时只需更改几个变量的值 因此DCB结构中其他值需要保持原值 以保证DCB中其他成员变量值正确

        ***如果设置时出现DCB成员变量XonChar 与XoffChar相同 则SetCommState 设置失败

    5.GetCommProperties 获取串口属性函数

        BOOL GetCommProperties(
HANDLE hFile,             // 通信设备(串口)句柄 通过CreateFile返回值得到
LPCOMMPROP lpCommProp   // 指向COMMPROP结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

    6.BuildCommDCB 设备控制块DCB填充函数

        BOOL BuildCommDCB(
LPCTSTR lpDef, // 设备控制字符串
LPDCB lpDCB    // DCB 结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

        lpDef:设置时用模式Model命令格式
eg:波特率9600，无奇偶校验位，8个数据位，1个停止位  "9600,N,8,1"

            BuildCommDCB函数填充好DCB结构数据后 由SetCommState函数设置后才能应用

    7.BuildCommDCBAndTimeouts 设备控制块DCB和超时Timeouts 填充函数

        BOOL BuildCommDCB(
LPCTSTR lpDef, // 设备控制字符串
LPDCB lpDCB,    // DCB 结构
LPCOMMTIMEOUTS lpCommTimeouts // COMMTIMEOUTS结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

    8. GetCommTimeouts 超时获取函数

        BOOL GetTimeouts(
HANDLE hFile, // 通信设备(串口)句柄 通过CreateFile返回值得到
LPCOMMTIMEOUTS lpCommTimeouts // COMMTIMEOUTS结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

        说明:
该函数用来获取指定通信设备(串口)的超时参数值

    9. SetCommTimeouts 超时设置函数

        BOOL SetCommTimeouts(
HANDLE hFile, // 通信设备(串口)句柄 通过CreateFile返回值得到
LPCOMMTIMEOUTS lpCommTimeouts // COMMTIMEOUTS结构
);

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

        说明:
该函数用来设置指定通信设备(串口)的超时参数值

    10. ReadFile 读串口函数
这两个函数用来完成读串口操作

        BOOL ReadFile(
HANDLE hFile ,         // 通信设备(串口)句柄 通过CreateFile 返回值得到
LPVOID lpBuffer,    // 指向接收缓冲区
DWORD nNumberOfBytesToRead,  // 指明要从缓冲区读取的字节数
LPDWORD lpNumberOfBytesRead, // 指明实际从串口设备中读取的字节数
LPOVERLAPPED lpOverlapped    // OVERLAPPED结构
);

        参数说明:
hFile
该句柄创是必须带有GENERIC_READ 权限

            lpNumberOfBytesRead
指向实际读取的字节数 ReadFile读操作之前 首先将其置为0

                Windows 2000/NT 操作系统下 lpOverlapped为NULL 没有设置 lpNumberOfBytesRead不能为 NULL
lpOverlapped不为NULL 已经设置 lpNumberOfBytesRead可以为 NULL

                如果上述是一个重叠I/O 可以通过GetOverlappedResult函数得到实际读取的字节数

                在Windows 9X 操作系统 该参数不能为NULL

            lpOverlapped
如果hFile 为 FILE_FLAG_OVERLAPPED 该参数不能为NULL 而且是一个OVERLAPPED结构 否则设置为NULL

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

        说明:
如果该函数是因为超时而返回 返回值任然为TRUE
当返回FALSE 也不一定是操作失败 如重叠I/O操作时 如果操作未完成函数就返回 那么ReadFile函数返回值为FALSE
GetLastError函数返回值为ERROR_IO_PENDING,
因此在处理错误信息时，最好调用GetLastError函数来得到进一步的错误信息

    11. WriteFile 写串口函数

        BOOL WriteFile(
HANDLE hFile ,         // 通信设备(串口)句柄 通过CreateFile 返回值得到
LPVOID lpBuffer,    // 指向发送缓冲区
DWORD nNumberOfBytesToRead,  // 设置要向串口发送缓冲区写入的字节数
LPDWORD lpNumberOfBytesRead, // 实际写入发送缓冲区的字节数
LPOVERLAPPED lpOverlapped    // OVERLAPPED结构
);

        参数说明:
hFile
该句柄创是必须带有GENERIC_WRITE 权限

            lpNumberOfBytesRead
指向实际写入的字节数 WriteFile写操作之前 首先将其置为0

                Windows 2000/NT 操作系统下 lpOverlapped为NULL 没有设置 lpNumberOfBytesRead不能为 NULL
lpOverlapped不为NULL 已经设置 lpNumberOfBytesRead可以为 NULL

                如果上述是一个重叠I/O 可以通过GetOverlappedResult函数得到实际写入的字节数

                在Windows 9X 操作系统 该参数不能为NULL

            lpOverlapped
如果hFile 为 FILE_FLAG_OVERLAPPED 该参数不能为NULL 而且是一个OVERLAPPED结构 否则设置为NULL

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

    12. ClearCommError 清除错误标志函数
在调用ReadFile 和WriteFile之前 应用程序应该先调用ClearCommError函数清除错误标志 
该函数负责报告指定错误和设备的当前状态

        BOOL ClearCommError(
HANDLE hFile, // 通信设备(串口)句柄 通过CreateFile 返回值得到
LPDWORD lpErrors, // 错误掩误类型
LPCOMSTAT lpStat  // pointer to buffer for communications status
);

        lpErrors 
错误掩误类型(32位变量) 
错误类型:
CE_BREAK                硬件检测到一个中断条件
CE_DNS                    win9x:一个并行设备没有被选择
CE_FRAME                硬件检测到一个帧错误
CE_IOE                    发生一个I/O操作错误
CE_MODE                    设置通信模式出错 或者句柄无效
CE_OOP                    win9x:并行设备缺纸
CE_OVERRUN                超速错误  下一个字符丢失’
CE_PTO                    win9x:并行设备发生超时错误
CE_RXOVER               接收缓冲区溢出错误 缓冲区满  或者接收到文件结束字符(EOF)后还收到了字符
CE_RXPARITY                硬件检测到一个奇偶校验错误
CE_TXFULL                发送缓冲区满  应用程序无法再发送数据

        lpStat 指向一个COMMSTAT结构 该结构返回通信设备状态信息 如果lpStat为NULL 不返回任何信息

        返回值:
如果函数调用成功 则返回非0值
调用失败 返回0 有错误时 可调用GetLastError 函数得到错误信息

    13 PurgeComm 终止读写 / 清空缓冲区函数