串口API函数介绍

2-CreateFile()

用途：打开串口

原型：HANDLE CreateFile(LPCTSTR lpFileName,

DWORD dwDesired Access,

DWORD dwShareMode,

LPSECUR IT Y_ATTRIBUTES lpSecurityAttributes,

DWORD dwCreationDistribution,

DWORD dwFlagsAndAttributes,

HANDLE hTemplateFile);

参数说明：

-lpFileName：要打开的文件名称。对串口通信来说就是COM1或COM2。

-dwDesired Access:读写模式设置。此处应该用GENERIC_READ及GENERIC_WR IT E。

-dwShareMode：串口共享模式。此处不允许其他应用程序共享，应为0。

-lpSecurityAttributes：串口的安全属性，应为0，表示该串口不可被子程序继承。

-dwCreationDistribution：创建文件的性质，此处为OPEN_EXISTING.

-dwFlagsAndAttributes：属性及相关标志，这里使用异步方式应该用FILE_FLAG_OVERLAPPED。

-hTemplateFile:此处为0。

操作说明：若文件打开成功，串口即可使用了，该函数返回串口的句柄，以后对串口操作时即可使用该句柄。

举例：HANDLE hComm;

hComm=CreateFile("COM1", //串口号

GENERIC_READ|GENERIC_WR IT E, //允许读写

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函数中可被直接利用。