说在前面的话:
　　该"概要"是我在学习Windows上的串口通信资源的时候顺便翻译的, 可能存在相当多的翻译得不正确的地方, 还有很多不妥的地方, 如果您觉得哪个地方出了问题, 请你联系我(屏幕的右上角有QQ临时会话), 我也作好修改工作, 以免让后面的人被误导了. 当然, 介绍Windows上用SDK编程的文章并不多------能找到的基本上介绍控件开发的, 真可惜我把VB忘了, MFC也不会, 更别提C4个加了------而我也几乎完全只是按照MS的原文译过来的, 并没有抓重点讲, 希望读者不要指责, 不过后来我应该会不断地对文章作一些勘误工作. 以使文章尽量"生动".

通信资源

通信资源是一种提供双向的, 异步数据流的物理或逻辑设备. 串口, 并口, 传真机, 调制解调器等都是通信资源的例子. 对于每一种通信资源, 都有一个由库或驱动组成的服务供应者, 它使得应用程序可以访问这些资源.
　　用这些方式写的一个示例程序:串口调试助手
　　地址:http://www.9mcu.com/9mcubbs/forum.php?mod=viewthread&tid=1023821&extra=page%3D1

1. 关于通信资源
    文件I/O函数(CreateFile,CloseHandle,ReadFile,ReadFileEx,WriteFile,WriteFileEx)为打开和关闭一个通信资源句柄, 执行读和写的功能提供了基本的接口. 这些通信接口函数提供了访问通信资源的方式. 下面的概要简单地描述了文件I/O函数的通信函数的使用.

1.1 通信资源句柄
    一个进程通过 CreateFile 函数打开一个通信资源的句柄. 比如说:指定COM1可以打开一个串口的句柄, LPT1可以打开一个并口的句柄. 如果指定的资源当前正被其它的进程所使用, CreateFile就会失败. 当前进程的任何线程都可以使用由CreateFile函数返回的句柄来标识某种资源.
    当进程调用CreateFile打开一个俼资源时, 它应该指定下列的属性:
        o 对指定的资源的读写操作类型
        o 句柄是否可被子进程继承
        o 句柄是否可用户重叠(异步)I/O操作(见 同步 部分)
    当进程调用CreateFile打开一个俼资源时, 它也必须为下列参数指定明确的值:
        o fdwShareMode参数必须设置为0, 即打开为独占模式
        o fdwCreate参数必须指定OPEN_EXISTING标志位
        o hTemplate参数必须为NULL
    当使用CreateFile直接打开一个设备的句柄时, 应用程序必须用字符串"\\.\"来标识该设备. 比如:要打开驱动器A, 就要为 CreateFile的lpszName 参数指定 "\\.\a:" 调用进程可以使用这个句柄通过DeviceIoControl函数向设备发出控制码.

1.2 通信资源设置的修改
    当用CreateFile打开一个串行通信资源的句柄时, 系统默认根据最后一次该资源被打开时的设置来初始化和配置该资源.  保留先前的设置可以使得用户在重新打开该资源时可通过一个 模式命令(mode command) 来获得指定的设置. 由先前的打开操作继承来的设置包括 设备控制块(DCB,Device Control Block), I/O操作超时值. 如果该设置从未被打开过, 它被配置为系统默认配置.
    要取得当前串行通信资源的配置状态, 进程可以调用GetCommState来获得, 该函数会用当前的配置设置填充串口DCB结构. 要修改该配置, 进程可以指定一个DCB结构然后调用SetCommState函数.
    DCB结构成员指定了一些配置设置, 比如波特率(baud rate),每字节的数据位, 每字节的停止位的长度. DCB的其它成员指定特殊的字符,开启奇偶校验,流量控制等. 当进程只是需要修改设置的一小部分时, 它应该先调用GetCommState用当前配置来填充DCB结构, 然后可以调节DCB结构中重要的成员值, 最后再用修改后的DCB结构通过调用SetCommState来重新配置该设备. 该过程能够确保DCB结构中没有被修改的成员包含正确合适的值. 比如, 一个常见的错误是用XonChar成员和XoffChar成员相等的DCB结构体去配置某个设备.
    BuildCommDCB函数提供修改DCB结构的另一种方式. BuildCommDCB使用了包含模式命令指定的波特率,奇偶校验方式,停止位长度,数据位长度等的字符串的命令行. 除设置合适的值来禁止XON/XOFF和硬件流量控制, DCB结构的其它成员不会被该函数修改. BuildCommDCB只会修改该结构体, 并不会去重新配置某个设备.
    SetCommState函数会重新配置通信资源, 但它并不会影响到驱动的内部输出/输入缓冲. 缓冲区不会被清除, 挂起的读写操作也不会被意外地终止.
    进程通过调用SetupComm函数来重新初始化一个通信资源, 它将执行以下操作:
        o 终止挂起的读写操作, 不管它是否完成
        o 抛弃未读取的字符, 并且释放指定资源驱动内部分配的输入/输出缓冲区
        o 重新分配内部输入/输出缓冲区
    进程不需要请求调用SetupComm. 如果一定要这样, 该资源的驱动会用第一次该通信资源被使用时的默认设置来初始化该设备.

1.3 通信资源的配置
    COMMCONFIG结构定义了通信资源,串口等的配置. 该结构的格式与通信资源的类型有关(提供者子类). 开始的一些结构成员是所有通信资源共有的. 附加的成员为指定的提供者子类所定义. 特殊的服务提供者也可以扩展该结构.
    应用程序可以通过调用GetCommConfig/SetCommConfig来得到/设置这些配置. 当资源被打开时, 通信资源被提供者子类的默认配置初始化. 要得到/设置提供者子类的默认配置, 调用GetDefaultCommConfig/SetDefaultCommConfig即可.
    要提示用户配置配置信息, 调用CommConfigDialog函数. 该函数显示一个由服务提供者提供的对话框并基于用户的输入来填充COMMCONFIG结构.

1.4 调制解调器的配置
    (略)

1.5 读和写操作
    Windows支持对串行通信资源的同步和异步(重叠)I/O文件操作. 重叠操作允许该文件操作在后台工作的同时调用线程可执行其它的任务. 线程调用ReadFile/ReadFileEx函数从通信资源中读取, 使用WriteFile/WriteFileEx函数写通信资源. ReadFile/WriteFile可以执行同步的异步操作, ReadFileEx和WriteFileEx仅可以执行异步操作.
    这些读写函数的表现形式受该函数是否被作为重叠文件操作,该句柄的超时设置, 该句柄的流量控制参数的影响.
    线程也可以通过TransmitCommChar函数来写通信资源, 该函数会写一个指定的字符在输出缓冲区中任何挂起数据之前. 该函数在传送一个高优先级信号到接收系统时很有用. 该传输操作也同时受到流量控制, 写超时, 同步操作的影响.
    线程可以调用PurgeComm函数抛弃设备输入/输出缓冲区的所有字符. PurgeComm也可以终止挂起的读写操作, 而不管它是否完成. 如果线程使用PurgeComm去清除输出缓冲区, 被删除的字符不会被传送. 为清空输出缓冲区并保证内容被传送, 线程可以调用FlushFileBuffers函数(同步操作). 注意, 虽然FlushFileBuffers受流量控制, 但不受写超时影响, 并且在所有挂起的写操作完成之前不会返回.

1.6 通信事件
    进程可以监视一系列发生于通信资源中的事件. 比如, 应用程序可以使用事件监视来决定什么时候CTS(clear to send)和DSR(data set ready)信号改变状态.
    进程可以通过调用SetCommMask函数创建事件的掩码来监视给定的通信资源. 要决定当前的通信资源的掩码, 可以调用GetCommMask, 下面的事件可供监视:

　　在指定一系列的事件后, 进程可以使用WaitCommEvent函数监视事件中事件之一发生. WaitCommEvent可用于同步或异步操作. 要了解同步的更多信息, 参阅同步部分.
    当事件掩码中的事件之一发生后, 进程完成等待操作并设置一个事件掩码变量来指示检测到的已经发生的事件的类型. 如果 SetCommMask 在等待挂起的操作时被调用, WaitCommMask返回一个错误.
当检测的事件信号(CTS,DSR等等)改变状态时, WaitCommEvent 会报告这个改变, 但报告的不是当前的状态, 只是一个改变而已. 要查询当前CTS,DSR,RLSD,响铃指示器的状态, 进程可以调用GetCommModemStatus函数.

1.7 扩展功能
    一些通信函数可以被设备通过EscapeCommFunction调用. 该函数发送一个代码指示设备去执行一个扩展函数. 比如: 应用程序可以用SETBREAK暂停字符发送, 并且可以用CLRBREAK继续发送, 这些特殊的操作也可以调用SetCommBreak/ClearCommBreak函数来完成. EscapeCommFunction也可以用于实现手动调制解调器控制. 比如:CLRDTR和SETDTR代码可以实现手动DTR流量控制. 注意, 当设备被配置为使能DTR握手, 或RTS行被使能时, 进程使用EscapeCommFunction操作DTR行会导致产生错误.
    DeviceIoControl 函数使进程可以直接发送扩展功能代码到指定的设备驱动, 以使设备产生指定的操作. DeviceIoControl使得设备关联了标准串行通信功能不支持的能力. 它使得应用程序可以使用独特的参数配置那个设备和任何设备相关的函数.

2.使用通信资源
    2.1 配置通信资源
    2.2 监视通信事件

2.1 配置通信资源
    参看下面的例子, 打开串口2, 填充DCB结构:

#include <windows.h>
#include <tchar.h>
#include <stdio.h>int main(int argc, char *argv[])
{DCB dcb;HANDLE hCom;BOOL fSuccess;TCHAR *pcCommPort = TEXT("COM2");hCom = CreateFile( pcCommPort,GENERIC_READ | GENERIC_WRITE,0,    // must be opened with exclusive-accessNULL, // default security attributesOPEN_EXISTING, // must use OPEN_EXISTING0,    // not overlapped I/ONULL  // hTemplate must be NULL for comm devices
                    );if (hCom == INVALID_HANDLE_VALUE) {// Handle the error.printf ("CreateFile failed with error %d.\n", GetLastError());return (1);}// Build on the current configuration, and skip setting the size// of the input and output buffers with SetupComm.
SecureZeroMemory(&dcb, sizeof(DCB));dcb.DCBlength = sizeof(DCB);fSuccess = GetCommState(hCom, &dcb);if (!fSuccess) {// Handle the error.printf ("GetCommState failed with error %d.\n", GetLastError());return (2);}// Fill in DCB: 57,600 bps, 8 data bits, no parity, and 1 stop bit.
dcb.BaudRate = CBR_57600;     // set the baud ratedcb.ByteSize = 8;             // data size, xmit, and rcvdcb.Parity = NOPARITY;        // no parity bitdcb.StopBits = ONESTOPBIT;    // one stop bit
fSuccess = SetCommState(hCom, &dcb);if (!fSuccess) {// Handle the error.printf ("SetCommState failed with error %d.\n", GetLastError());return (3);}_tprintf (TEXT("Serial port %s successfully reconfigured.\n"), pcCommPort);return (0);
}

2.2 监视通信事件
    下面的例子采用异步方式打开串口, 创建事件监视掩码CTS,DSR信号, 并且等待一个事件的发生. WaitCommEvent函数应该被执行为异步操作, 所以在此等待期间, 其它线程可以做其它的事情.

#include <windows.h>
#include <assert.h>
#include <stdio.h>void main( )
{HANDLE hCom;OVERLAPPED o;BOOL fSuccess;DWORD dwEvtMask;hCom = CreateFile( TEXT("COM1"),GENERIC_READ | GENERIC_WRITE,0,    // exclusive access NULL, // default security attributes
        OPEN_EXISTING,FILE_FLAG_OVERLAPPED,NULL );if (hCom == INVALID_HANDLE_VALUE) {// Handle the error. printf("CreateFile failed with error %d.\n", GetLastError());return;}// Set the event mask.
fSuccess = SetCommMask(hCom, EV_CTS | EV_DSR);if (!fSuccess) {// Handle the error. printf("SetCommMask failed with error %d.\n", GetLastError());return;}// Create an event object for use by WaitCommEvent.
o.hEvent = CreateEvent(NULL,   // default security attributes TRUE,   // manual-reset event FALSE,  // not signaled NULL    // no name
        );// Initialize the rest of the OVERLAPPED structure to zero.o.Internal = 0;o.InternalHigh = 0;o.Offset = 0;o.OffsetHigh = 0;assert(o.hEvent);if (WaitCommEvent(hCom, &dwEvtMask, &o)) {if (dwEvtMask & EV_DSR) {// To do.
        }if (dwEvtMask & EV_CTS) {// To do.
        }}else{DWORD dwRet = GetLastError();if( ERROR_IO_PENDING == dwRet){printf("I/O is pending...\n");// To do.
        }else printf("Wait failed with error %d.\n", GetLastError());}
}

3.通信资源参考
    3.1 通信函数
    3.2 通信控制码
    3.3 通信结构体

3.1 通信函数
3.1.1 BuildCommDCB

3.1.2 BuildCommDCBAndTimeouts

3.1.3 ClearCommBreak

3.1.4 ClearCommError

3.1.5 CommConfigDialog

3.1.6 EscapeCommFunction

---pre---