WIN32 API多线程操作串口代码文档经典教程

WIN32 API 串口通讯实例教程

API 函数不仅提供了打开和读写通讯端口的操作方法，还提供了名目繁多的函数以支持

对串行通讯的各种操作。常用函数及作用下：

函数名 作用

CreateFile 打开串口

GetCommState 检测串口设置

SetCommState 设置串口

WriteFile 发送数据

ReadFile 接收数据

GetOverlappedResult 返回最后重叠（异步）操作结果

PurgeComm 清空串口缓冲区,退出所有相关操作

ClearCommError 更新串口状态结构体,并清除所有串口硬件错误

CloseHandle 关闭串行口

用 Windows API 编写串口程序本身是有巨大优点的，因为控制能力会更强，效率也会更

高。

API 编写串口，过程一般是这样的：

1、 创建串口句柄，用 CreateFile；

从字面上去理解，大家也可以发现 CreateFile 实际上表明 Windows 是把串口当作一个文

件来处理的，所以它也有文件那样的缓冲区、句柄、读写错误等，不同的是，这个文件名字

只有固定的几个（一般为四个），而且始终存在（EXSITING），而且在调用 CreateFile 的时候

请注意它的参数。CreateFile 函数原型如下：

HANDLE CreateFile(LPCTSTR lpFileName,

DWORD dwDesiredAccess,

DWORD dwShareMode,

LPSECURITY_ATTRIBUTES lpSecurityAttributes,

DWORD dwCreationDisposition,

的读访问权)或 GENERIC_WRITE（指定该文件的写访问权）两个值之一或同时为为这两个值。

用 ENERIC_READ|GENERIC_WRITE 则指定可对串口进行读写;

dwShareMode：指定此文件可以怎样被共享。因为串行口不支持任何共享模式，所以

dwShareMode 必须设为０;

lpSecurityAttributes 定义安全属性，一般不用，可设为 NULL。Win 9x 下该参数被忽

略；

dwCreationDistribution 定义文件创建方式， 对串口必须设为 OPEN_EXISTING，表示打

开已经存在的文件；

dwFlagsAndAttributes 为 该 文 件 指 定 定 义 文 件 属 性 和 标 志 ， 这 个 程 序 中 设 为

FILE_FLAG_OVERLAPPED，表示异步通信方式；

上面说到了异步，那什么是异步呢？异步是相对同步这个概念而言的。异步，就是说，

响应用户操作；同步，相反，响应的 I/O 操作必须完成后函数才返回，否则阻塞线程。对于

一些很简单的通讯程序来说，可以选择同步，这样可以省去很多错误检查，但是对于复杂一

点的应用程序，异步是最佳选择。

实例 1：

/****************** example1.cpp ******************************************/

{

HANDLE hComm;

hComm = CreateFile(portname, //串口号

GENERIC_READ | GENERIC_WRITE, //允许读写

0, //通讯设备必须以独占方式打开

0, //无安全属性

OPEN_EXISTING, //通讯设备已存在

FILE_FLAG_OVERLAPPED, //异步 I/O

0); //通讯设备不能用模板打开

if (hComm == INVALID_HANDLE_VALUE)

{

void main()

{

bool open;

open=openport("com2");

if(open)

printf("open comport success");

system("pause") ;

}

/************************** program end***************************************/

/* lishaoan 2009-06-29 *****************************************************/

#include <windows.h>

#include <stdio.h>

#include <stdlib.h>

bool openport(char *portname)//打开串口

0, //无安全属性

0, //同步 I/O

0); //通讯设备不能用模板打开

if (hComm == INVALID_HANDLE_VALUE)

{

CloseHandle(hComm);

return FALSE;

}

else

return true;

}

system("pause") ;

}

/************************** program end***************************************/

第三节 设置串口

在打开通信设备句柄后，常常需要对串行口进行一些初始化工作。这需要通过一个 DCB

结构来进行。DCB 结构包含了诸如波特率、每个字符的数据位数、奇偶校验和停止位数等信

息。在查询或配置串口的属性时，都要用 DCB 结构来作为缓冲区。

第一次打开串口时，串口设置为系统默认值，函数 GetCommState 和 SetCommState 可用

于检索和设定端口设置的 DCB(设备控制块)结构，该结构中 BaudRate、ByteSize、StopBits

和 Parity 字段含有串口波特率、数据位数、停止位和奇偶校验控制等信息。

程序中用 DCB 进行串口设置时，应先调用 API 函数 GetCommState，来获得串口的设置信

息：

GetCommState()

口的参数结构，修改部分参数后再将参数结构写入。

然后在需要设置的地方对 dcb 进行设置。串口有很多的属性，上面也已经介绍了一些最

重要的参数。这里介绍数据结构 DCB：

typedef struct _DCB { // dcb

DWORD DCBlength; //DCB 结构体大小

DWORD BaudRate; //波特率

DWORD fBinary: 1; //是否是二进制，一般设置为 TRUE

DWORD fParity: 1;//是否进行奇偶校验

DWORD fOutxCtsFlow:1; //CTS 线上的硬件握手

DWORD fOutxDsrFlow:1; //DSR 线上的硬件握手

DWORD fDsrSensitivity:1;

// DSR sensitivity

DWORD fTXContinueOnXoff:1;

DWORD fOutX: 1; //是否使用 XON/XOFF 协议

DWORD fErrorChar: 1; //发送错误协议

DWORD fNull: 1;

DWORD fRtsControl:2;

BYTE StopBits; //停止位数