在CB6下基于api函数编写串口通信程序简介

核心提示：1-在C++ Builder 6.0下基于api函数编写串口通信程序简介： 在dos/win95/win98的年代，操作系统对串口是不保护的，在CB6下基于api函数编写串口通信程序简介，也就是说将串口的的资源完全 开放给用户，用户可以用直接操作硬件的函数(比如说TC2.0下的inport()和outport()函数)

　　1-在C++ Builder 6.0下基于api函数编写串口通信程序简介：
在dos/win95/win98的年代，操作系统对串口是不保护的，也就是说将串口的的资源完全
开放给用户，用户可以用直接操作硬件的函数(比如说TC2.0下的inport()和outport()函数)
跟串口直接打交道，这时候用户使用直接操作串口的函数怎样"折磨"串口都是没有问题的，
操作系统根本就不管不问，对串口操作所造成的一切后果都是用户一个人承担的，这时候用
户对串口具有高度自由的支配权；但是，这种情况好景不长，从win2000操作系统开始，微软
为了"照顾好"计算机上的硬件，开始实施了对硬件的保护策略，也就是说任何用户在他的操作
系统下企图操纵串口时必须经过他的同意方可进行，其实也就是变相的将用户往必须使用他的
通信api函数才能操作串口这条"羊肠小路"上赶(当然也有别的方法操作串口，但那些并非我等
普通用户能研究明白的)，形象一点说就似乎你想怎样操作串口的意图必须经过win2000的翻译
(其实是win2000的设备驱动程序)才能转达给串口一样，基于这一点我们说(其实是很多资料上
说的)win2000下通过api函数操作串口是具有"设备无关性的"，什么意思呢？就是说你想怎样
操作串口就用相应的api函数告诉操作系统你想对串口干什么，然后操作系统就把你的意思转
告给串口让其做出相应的动作，相对于dos/win95/win98下来说，据我理解也就相当于你原来
写的直接操作串口的函数在win2000下他替你完成了，但是你必须用win2000通信api函数清楚
地向操作系统表达清楚你到底想干什么，所以说在这种情况下要想写好串口驱动程序你就必须
至少弄明白win2000下的通信api函数都是干什么的方可，啰里啰唆唠叨了这么多... ...sorry,
还没完呢，至少还有一件事我想说，原来在dos/win95/win98系统下有好多高手用c/c++对串口
进行直接操作是非常熟练的，尤其是dos时代的turbo 2.0操作串口的高手他们写的串口驱动程
序直到win98的时候还用的非常洋洋自得，但是到了win2000的时候，他们的程序忽然不好使了
，而他们有的可能还会因为知识结构上的滞后始终弄不明白怎么回事儿，兄弟们，你们该明白
了吧？闲话少叙，下面介绍笔者写串口通信函数时用到的各个api函数---------
2-CreateFile()
用途：打开串口
原型：HANDLE CreateFile(LPCTSTR lpFileName,
DWord dwDesiredaccess,
DWORD dwShareMode,
LPSECUR99vY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDistribution,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile);
参数说明：
-lpFileName：要打开的文件名称。对串口通信来说就是COM1或COM2。
-dwDesiredAccess:读写模式设置。此处应该用GENERIC_READ及GENERIC_WR99vE。
-dwShareMode：串口共享模式。此处不答应其他应用程序共享，应为0。
-lpSecurityAttributes：串口的安全属性，应为0，表示该串口不可被子程序继续。
-dwCreationDistribution：创建文件的性质，此处为OPEN_EXISTING.
-dwFlagsAndAttributes：属性及相关标志，这里使用异步方式应该用FILE_FLAG_OVERLAPPED。
-hTemplateFile:此处为0。
操作说明：若文件打开成功，串口即可使用了，该函数返回串口的句柄，以后对串口操作时
即可使用该句柄。
举例：HANDLE hComm;
hComm=CreateFile("COM1", //串口号
GENERIC_READGENERIC_WR99vE, //答应读写
0, //通讯设备必须以独占方式打开
NULL, //无安全属性
OPEN_EXISTING, //通讯设备已存在
FILE_FLAG_OVERLAPPED, //异步I/O
0); //通讯设备不能用模板打开
hComm即为函数返回的串口1的句柄。
3-CloseHandle()
用途：关闭串口

原型：BOOL CloseHandle(HANDLE hObjedt)
参数说明：
-hObjedt：串口句柄
操作说明：成功关闭串口时返回true,否则返回false
举例：CloseHandle(hComm);
4-GetCommState()
用途：取得串口当前状态
原型：BOOL GetCommState(HANDLE hFile,
LPDCB lpDCB);
参数说明：
-hFile：串口句柄
-lpDCB：设备控制块(Device Control Block)结构地址。此结构中含有和设备相关的
参数。此处是与串口相关的参数。由于参数非常多，当需要设置串口参数
时，通常是先取得串口的参数结构，修改部分参数后再将参数结构写入。
在此仅介绍少数的几个常用的参数：
DWORD BaudRate：串口波特率
DWORD fParity：为1的话激活奇偶校验检查
DWORD Parity：校验方式，值0~4分别对应无校验、奇校验、偶校验、校验
置位、校验清零
DWORD ByteSize：一个字节的数据位个数，范围是5~8
DWORD StopBits：停止位个数，0~2分别对应1位、1.5位、2位停止位
操作举例：DCB ComDCB; //串口设备控制块
GetCommState(hComm,&ComDCB);
5-SetCommState()
用途：设置串口状态，包括常用的更改串口号、波特率、奇偶校验方式、数据位数等
原型：BOOL SetCommState(HANDLE hFile,
LPDCB lpDCB);
参数说明：
-hFile:串口句柄
-lpDCB：设备控制块(Device Control Block)结构地址。要更改的串口参数包含在此结构中。
操作举例：DCB ComDCB;
GetCommState(hComm,&ComDCB);//取得当前串口状态
ComDCB.BaudRate=9600;//更改为9600bps,该值即为你要修改后的波特率
SetCommState(hComm,&ComDCB;//将更改后的参数写入串口
6-WriteFile()
用途：向串口写数据
原型：BOOL WriteFile(HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped);
参数说明：
-hFile：串口句柄
-lpBuffer：待写入数据的首地址
-nNumberOfBytesToWrite：待写入数据的字节数长度
-lpNumberOfBytesWritten：函数返回的实际写入串口的数据个数的地址，利用此变量可判定
实际写入的字节数和预备写入的字节数是否相同。
-lpOverlapped:重叠I/O结构的指针
操作举例：DWORD BytesSent=0;
unsigned char SendBytes[5]={1,2,3,4,5};
OVERLAPPED ov_Write;
ov_Write.Offset=0;
ov_Write.OffsetHigh=0;
WriteFile(hComm, //调用成功返回非零，失败返回零
SendBytes, //输出缓冲区
5, //预备发送的字符长度
&BytesSent, //实际发出的字符数
&ov_Write); //重叠结构
假如函数执行成功的话检查BytesSent的值应该为5，此函数是WriteFile函数执行完毕后
自行填充的，利用此变量的填充值可以用来检查该函数是否将所有的数据成功写入串口
7-ReadFile()
用途：读串口数据
原型：BOOL ReadFile(HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
lpNumberOfBytesRead,
lpOverlapped);
参数说明：
-hFile：串口句柄
-lpBuffer：存储被读出数据的首地址
-nNumberOfBytesToRead：预备读出的字节个数
-NumberOfBytesRead：实际读出的字节个数
-lpOverlapped：异步I/O结构，
操作举例：unsigned char UCRxBuff[20];
COMSTAT ComStat;
DWORD dwError=0;
DWORD BytesRead=0;
OVERLAPPED ov_Read;
ov_Read.hEvent=CreateEvent(NULL, true, false, NULL);//必须创建有效事件

ClearCommError(hComm,&dwError,&ComStat);//检查串口接收缓冲区中的数据个数

bResult=ReadFile(hComm, //串口句柄
ucRxBuff, //输入缓冲区地址
ComStat.cbInQue, //想读入的字符数
&BytesRead, //实际读出的字节数的变量指针
&ov_Read); //重叠结构指针
假如当前串口中有5个字节数据的话，那么执行完ClearCommError()函数后，ComStat
结构中的ComStat.cbInQue将被填充为5，此值在ReadFile函数中可被直接利用。
8-ClearCommError()
用途：清除串口错误或者读取串口现在的状态
原型：BOOL ClearCommError(HANDLE hFile,
LPDWORD lpErrors,
LPCOMATAT lpStat
);
参数说明:
-hFile:串口句柄
-lpErrors：返回错误数值，错误常数如下：
1-CE_BREAK:检测到中断信号。意思是说检测到某个字节数据缺少合法的停止位。
2-CE_FRAME:硬件检测到帧错误。
3-CE_IOE:通信设备发生输入/输出错误。
4-CE_MODE:设置模式错误，或是hFile值错误。
5-CE_OVERRUN:溢出错误，缓冲区容量不足，数据将丢失。
6-CE_RXOVER:溢出错误。
7-CE_RXPAR99vY:硬件检查到校验位错误。
8-CE_TXFULL:发送缓冲区已满。
-lpStat:指向通信端口状态的结构变量，原型如下：
typedef struct _COMSTAT{
...
...
DWORD cbInQue; //输入缓冲区中的字节数
DWORD cbOutQue;//输出缓冲区中的字节数
}