参考文档windowsapi程序范例优秀word范文 22页.docx

参考文档windowsapi程序范例优秀word范文 22页.docx

《参考文档windowsapi程序范例优秀word范文 22页.docx》由会员分享，可在线阅读，更多相关《参考文档windowsapi程序范例优秀word范文 22页.docx（18页珍藏版）》请在冰豆网上搜索。

参考文档windowsapi程序范例优秀word范文22页

本文部分内容来自网络整理，本司不为其真实性负责，如有异议或侵权请及时联系，本司将立即删除！

==本文为word格式，下载后可方便编辑和修改！

==

windowsapi程序范例

篇一：

WIN_API串口通信详细讲解带范例程序说明

WIN32API串口通讯实例教程

第一节实现串口通讯的函数及串口编程简介

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

常用函数及作用下：

函数名作用

CreateFile打开串口

GetCommState检测串口设置

SetCommState设置串口

BuilderCommDCB用字符串中的值来填充设备控制块

GetCommTimeouts检测通信超时设置

SetCommTimeouts设置通信超时参数

SetCommMask设定被监控事件

WaitCommEvent等待被监控事件发生

WaitForMultipleObjects等待多个被监测对象的结果

WriteFile发送数据

ReadFile接收数据

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

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

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

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

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

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

2、对串口的参数进行设置，其中比较重要的是波特率（BaudRate），数据宽度（BytesBits），奇偶校验（Parity），停止位（StopBits），当然，重要的还有端口号（Port）；

3、然后对串口进行相应的读写操作，这时候用到ReadFile和WriteFile函数；

4、读写结束后，要关闭串口句柄，用CloseFile。

下面依次讲述各个步骤的过程。

第二节创建串口句柄打开串口

从字面上去理解，大家也可以发现CreateFile实际上表明Windows是把串口当作一个文件来处理的，所以它也有文件那样的缓冲区、句柄、读写错误等，不同的是，这个文件名字只有固定的几个（一般为四个），而且始终存在（EXSITING），而且在调用CreateFile的时候请注意它的参数。

CreateFile函数原型如下：

HANDLECreateFile（LPCTSTRlpFileName,

DWORDdwDesiredAccess,

DWORDdwShareMode,

LPSECURITY_ATTRIBUTESlpSecurityAttributes,DWORDdwCreationDisposition,

DWORDdwFlagsAndAttributes,

HANDLEhTemplateFile）;

lpFileName：

指向一个以NULL结束的字符串，该串指定了要创建、打开或截断的文件、管道、通信源、磁盘设备或控制台的名字。

当用CreateFile打开串口时，这个参数可用“COM1”指定串口1，用“COM2”指定串口2，依此类推。

dwDesireAccess：

指定对文件访问的类型，该参数可以为GENERIC_READ（指定对该文件的读访问权）或GENERIC_WRITE（指定该文件的写访问权）两个值之一或同时为为这两个值。

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

dwShareMode：

指定此文件可以怎样被共享。

因为串行口不支持任何共享模式，所以dwShareMode必须设为０;

lpSecurityAttributes定义安全属性，一般不用，可设为NULL。

Win9x下该参数被忽略；

dwCreationDistribution定义文件创建方式，对串口必须设为OPEN_EXISTING，表示打开已经存在的文件；

dwFlagsAndAttributes为该文件指定定义文件属性和标志，这个程序中设为FILE_FLAG_OVERLAPPED，表示异步通信方式；

hTemplateFile指向一个模板文件的句柄，串口无模板可言，设为NULL。

在Windows9x下该参数必须为NULL。

串口被成功打开时，返回其句柄，否则返回INVALID_HANDLE_value（0XFFFFFFFF）。

上面说到了异步，那什么是异步呢？

异步是相对同步这个概念而言的。

异步，就是说，在进行串口读写操作时，不用等到I/O操作完成后函数才返回，也就是说，异步可以更快得响应用户操作；同步，相反，响应的I/O操作必须完成后函数才返回，否则阻塞线程。

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

实例1：

/******************example1.cpp******************************************//*lishaoan201X-06-29*****************************************************//*******************************************************/

#include

#include

#include

boolopenport（char*portname）//打开串口

{

HANDLEhComm;

hComm=Creat

eFile（portname,//串口号

GENERIC_READ|GENERIC_WRITE,//允许读写

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

0,//无安全属性

OPEN_EXISTING,//通讯设备已存在

FILE_FLAG_OVERLAPPED,//异步I/O

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

if（hComm==INVALID_HANDLE_VALUE）

{

CloseHandle（hComm）;

returnFALSE;

}

else

returntrue;

}

voidmain（）

{

boolopen;

open=openport（"com2"）;

if（open）

printf（"opencomportsuccess"）;

system（"pause"）;

}

/**************************programend***************************************/

实例2：

/******************example2.cpp******************************************//*lishaoan201X-06-29*****************************************************//*******************************************************/

#include

#include

#include

boolopenport（char*portname）//打开串口

{

HANDLEhComm;

hComm=CreateFile（portname,//串口号

GENERIC_READ|GENERIC_WRITE,//允许读写

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

0,//无安全属性

OPEN_EXISTING,//通讯设备已存在

0,//同步I/O

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

if（hComm==INVALID_HANDLE_VALUE）

{

CloseHandle（hComm）;

returnFALSE;

}

else

returntrue;

}

voidmain（）

{

boolopen;

open=openport（"com2"）;

if（open）

printf（"opencomportsuccess"）;

system（"pause"）;

}

/**************************programend***************************************/

第三节设置串口

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

这需要通过一个DCB结构来进行。

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

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

第一次打开串口时，串口设置为系统默认值，函数GetCommState和SetCommState可用于检索和设定端口设置的DCB（设备控制块）结构，该结构中BaudRate、ByteSize、StopBits和Parity字段含有串口波特率、数据位数、停止位和奇偶校验控制等信息。

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

GetCommState（）

用途：

取得串口当前状态

原型：

BOOLGetCommState（HANDLEhFile,LPDCBlpDCB）;

参数说明：

-hFile：

串口句柄

-lpDCB：

设备控制块（DeviceControlBlock）结构地址。

此结构中含有和设备相关的参数。

此处是与串口相关的参数。

由于参数非常多，当需要设置串口参数时，通常是先取得串口的参数结构，修改部分参数后再将参数结构写入。

然后在需要设置的地方对dcb进行设置。

串口有很多的属性，上面也已经介绍了一些最重要的参数。

这里介绍数据结构DCB：

typedefstruct_DCB{//dcb

DWORDDCBlength;//DCB结构体大小

DWORDBaudRate;//波特率

DWORDfBinary:

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

DWORDfParity:

1;//是否进行奇偶校验

DWORDfOutxCtsFlow:

1;//CTS线上的硬件握手

DWORDfOutxDsrFlow:

1;//DSR线上的硬件握手

DWORDfDtrControl:

2;//DTR控制

DWORDfDsrSensitivity:

1;//DSRsensitivity

DWORDfTXContinueOnXoff:

1;//XOFFcontinuesTx

DWORDfOutX:

1;//是否使用XON/XOFF协议

DWORDfInX:

1;//是否使用XON/XOFF协议

DWORDfErrorChar:

1;//发送错误协议

DWORDfNull:

1;//enablenullstripping

DWORDfRtsControl:

2;//RTSflowcontrol

DWORDfAbortOnError:

1;//abortreads/writesonerror

DWORDfDummy2:

17;//reserved

WORDwReserved;//notcurrentlyused

WORDXonLim;//设置在XON字