/*-----------------------------------------------------------------------------

    This is a part of the Microsoft Source Code Samples. 
    Copyright (C) 1995 Microsoft Corporation.
    All rights reserved. 
    This source code is only intended as a supplement to 
    Microsoft Development Tools and/or WinHelp documentation.
    See these sources for detailed information regarding the 
    Microsoft samples programs.

    MODULE: Init.c

    PURPOSE: 初始化全局数据和通信端口连接。 关闭通信端口并清除全局数据。

    FUNCTIONS:
        GlobalInitialize  - 初始化全局变量和系统对象
        GlobalCleanup     - 清除全局变量和系统对象
        ClearTTYContents  - 清除tty缓冲区
        InitNewFont       - 为TTY子窗口创建一个新字体
        CreateTTYInfo     - 创建动态tty数据，控制tty的行为
        DestroyTTYInfo    - 销毁tty信息数据
        StartThreads      - 打开端口时启动工作线程
        SetupCommPort     - 第一次打开港口
        WaitForThreads    - 设置线程退出事件并等待工作线程退出
        BreakDownCommPort - 关闭与comm端口的连接
        DisconnectOK      - 询问用户是否可以断开连接        
		QuerySingleSerialPortEx(int nPort)	- 查询指定端口状态
		QuerySerialPortStatusEx	- 查询指定范围端口状态

-----------------------------------------------------------------------------*/

#include <windows.h>
#include <commctrl.h>
#include <stdio.h>
#include "mttty.h"

//#pragma comment(lib,"comctl32.lib")

/*
    Prototypes for functions called only within this file
*/
void StartThreads( void );
DWORD WaitForThreads( DWORD );

/*
    TimeoutsDefault
		我们需要ReadIntervalTimeout来执行读取操作 我们这样做是为了超时并变得重叠。 在这里指定1会使ReadFile很快返回
		这样我们的读取线程将继续执行。
		参考定义
*/
COMMTIMEOUTS gTimeoutsDefault = { 0x01, 0, 0, 0, 0 };


/*-----------------------------------------------------------------------------

FUNCTION: GlobalInitialize

PURPOSE: 在创建任何窗口之前初始化全局变量

COMMENTS: 相应函数 GlobalCleanup

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
void GlobalInitialize()
{
    int cyMenuHeight, cyCaptionHeight, cyFrameHeight;

    // critical sections in status reporting & node management
    // 初始化互斥对象
    InitializeCriticalSection(&gStatusCritical);
    InitializeCriticalSection(&gcsWriterHeap);
    InitializeCriticalSection(&gcsDataHeap);
    // 状态消息事件
    ghStatusMessageEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
    if (ghStatusMessageEvent == NULL)
        ErrorReporter("CreateEvent (Status message event)");

    //
    //线程退出事件
    //
    ghThreadExitEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
    if (ghThreadExitEvent == NULL)
        ErrorReporter("CreateEvent (Thread exit event)");        

    //
    //用于文件传输状态栏
    //
    InitCommonControls();

    //
    // 字体控制
    //
    ghFontStatus = CreateStatusEditFont();

    //
    //下面的内容用于调整tty窗口和对话框窗口的大小
    //
    gwBaseY = HIWORD(GetDialogBaseUnits());
    cyMenuHeight = GetSystemMetrics(SM_CYMENU);
    cyCaptionHeight = GetSystemMetrics(SM_CYCAPTION);
    cyFrameHeight = GetSystemMetrics(SM_CYFRAME);
    gcyMinimumWindowHeight = cyMenuHeight + \
                            4 * cyCaptionHeight + \
                            2 * cyFrameHeight +
                            (SETTINGSFACTOR + STATUSFACTOR) * gwBaseY ;
    return ;
}


/*-----------------------------------------------------------------------------

FUNCTION: GlobalCleanup

PURPOSE: 清除所有全局变量

COMMENTS: Partner to GlobalInitialize

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
void GlobalCleanup()
{
    DeleteCriticalSection(&gStatusCritical);
    DeleteCriticalSection(&gcsWriterHeap);
    DeleteCriticalSection(&gcsDataHeap);
    DeleteObject(ghFontStatus);
    CloseHandle(ghStatusMessageEvent);
    CloseHandle(ghThreadExitEvent);
    HeapDestroy(ghStatusMessageHeap);
    return;
}


/*-----------------------------------------------------------------------------

FUNCTION: ClearTTYContents

PURPOSE: 清除tty缓冲区

RETURN: always TRUE

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
BOOL ClearTTYContents()
{
    FillMemory(g_appdata.Screen, MAXCOLS*MAXROWS, ' ');
    return TRUE;
}


/*-----------------------------------------------------------------------------

FUNCTION: InitNewFont(LOGFONT, COLORREF)

PURPOSE: 初始化在TTY窗口上使用的字体

PARAMETERS:
    LogFont  - 逻辑字体
    rgbColor - 字体颜色

COMMENTS: 当用户建立新连接或更改TTY字体时调用。

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
void InitNewFont(LOGFONT LogFont, COLORREF rgbColor)
{
    TEXTMETRIC tm;
    HDC        hDC;

    //
    //如果旧字体存在，那么我应该删除它
    //
    if (g_appdata.hTTYFont)
        DeleteObject(g_appdata.hTTYFont);

    g_appdata.lfTTYFont = LogFont;
    g_appdata.hTTYFont = CreateFontIndirect(&(g_appdata.lfTTYFont));
    g_appdata.rgbFGColor = rgbColor;
	g_appdata.rgbBGColor = RGB(255,255,255);

    hDC = GetDC( ghwndMain ) ;
    SelectObject( hDC, g_appdata.hTTYFont ) ;
    GetTextMetrics( hDC, &tm ) ;
    ReleaseDC( ghwndMain, hDC ) ;

    //
	//字符的宽度和高度
    //
    g_appdata.xChar = tm.tmAveCharWidth  ;
    g_appdata.yChar = tm.tmHeight + tm.tmExternalLeading ;

    g_appdata.xOffset = 0 ;
    g_appdata.yOffset = g_appdata.yChar * g_appdata.nRow;
}

/*-----------------------------------------------------------------------------

FUNCTION: InitTTYInfo

PURPOSE: 初始化TTY数据

COMMENTS: 这个结构是这个程序所有部分使用的TTY属性的集合

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it
            2/14/96   AllenD      Removed npTTYInfo

-----------------------------------------------------------------------------*/
BOOL InitTTYInfo()
{
    
	g_appdata.hCommPort      = NULL ;
    g_appdata.fConnected     = FALSE ;
    g_appdata.fLocalEcho     = FALSE ;
    g_appdata.wCursorState  = CS_HIDE ;
    g_appdata.bPort          = 1 ;
    g_appdata.dwBaudRate      = 921600 ;
    g_appdata.bByteSize      = 8 ;
    g_appdata.bParity        = NOPARITY ;
    g_appdata.bStopBits      = ONESTOPBIT ;
    g_appdata.fAutowrap      = TRUE;
    g_appdata.fNewLine       = FALSE;
    g_appdata.xSize         = 0 ;
    g_appdata.ySize         = 0 ;
    g_appdata.xScroll       = 0 ;
    g_appdata.yScroll       = 0 ;
    g_appdata.nColumn        = 0 ;
    g_appdata.nRow           = MAXROWS - 1 ;
    g_appdata.fDisplayErrors = TRUE ;

    //
    // 超时
    //
    g_appdata.timeoutsnew   = gTimeoutsDefault;

    //
    // read state and status events
    //
    gdwReceiveState            = RECEIVE_TTY;
    g_appdata.dwEventFlags    = EVENTFLAGS_DEFAULT;
    g_appdata.chFlag      = FLAGCHAR_DEFAULT;

    //
    // Flow Control Settings
    //
    g_appdata.fDtrControl    = DTR_CONTROL_ENABLE;
    g_appdata.fRtsControl    = RTS_CONTROL_ENABLE;
    g_appdata.chXON       = ASCII_XON;
    g_appdata.chXOFF      = ASCII_XOFF;
    g_appdata.wXONLimit      = 0;
    g_appdata.wXOFFLimit     = 0;
    g_appdata.fCTSOutFlow    = FALSE;
    g_appdata.fDSROutFlow    = FALSE;
    g_appdata.fDSRInFlow     = FALSE;
    g_appdata.fXonXoffOutFlow  = FALSE;
    g_appdata.fXonXoffInFlow   = FALSE;
    g_appdata.fTXafterXoffSent = FALSE;

    g_appdata.fNoReading       = FALSE;
    g_appdata.fNoWriting       = FALSE;
    g_appdata.fNoEvents        = FALSE;
    g_appdata.fNoStatus        = FALSE;
    g_appdata.fDisplayTimeouts    = FALSE;

    //
    // setup default font information
    // 
    g_appdata.lfTTYFont.lfHeight =         20 ;
    g_appdata.lfTTYFont.lfWidth =          0 ;
    g_appdata.lfTTYFont.lfEscapement =     0 ;
    g_appdata.lfTTYFont.lfOrientation =    0 ;
    g_appdata.lfTTYFont.lfWeight =         0 ;
    g_appdata.lfTTYFont.lfItalic =         0 ;
    g_appdata.lfTTYFont.lfUnderline =      0 ;
    g_appdata.lfTTYFont.lfStrikeOut =      0 ;
    g_appdata.lfTTYFont.lfCharSet =        OEM_CHARSET ;
    g_appdata.lfTTYFont.lfOutPrecision =   OUT_DEFAULT_PRECIS ;
    g_appdata.lfTTYFont.lfClipPrecision =  CLIP_DEFAULT_PRECIS ;
    g_appdata.lfTTYFont.lfQuality =        DEFAULT_QUALITY ;
    g_appdata.lfTTYFont.lfPitchAndFamily = FIXED_PITCH | FF_MODERN ;
    strcpy( g_appdata.lfTTYFont.lfFaceName, "宋体" ) ;
	g_appdata.DownloadReday = FALSE;

    InitNewFont( g_appdata.lfTTYFont, RGB(0,0,0));

    ClearTTYContents();

    return ( TRUE ) ;
}

/*-----------------------------------------------------------------------------

FUNCTION: DestroyTTYInfo

PURPOSE: 释放与TTYInfo结构体相关的对象

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it
            2/14/96   AllenD      Removed npTTYInfo

-----------------------------------------------------------------------------*/
void DestroyTTYInfo()
{
    DeleteObject(g_appdata.hTTYFont);
}

/*-----------------------------------------------------------------------------

FUNCTION: StartThreads

PURPOSE:创建读取/状态和写入线程

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
void StartThreads(void)
{
	DWORD			dwReadStatId;
	DWORD			dwWriterId;
	g_appdata.hReaderStatus = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE) ReaderAndStatusProc, (LPVOID) ghWndTTY, 0, &dwReadStatId);
	if (g_appdata.hReaderStatus == NULL)
		ErrorInComm("CreateThread(Reader/Status)");
	g_appdata.hWriter = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE) WriterProc, (LPVOID) NULL, 0, &dwWriterId);
	if (g_appdata.hWriter == NULL)
		ErrorInComm("CreateThread (Writer)");
	return;
}



/*-----------------------------------------------------------------------------

FUNCTION: SetupCommPort( void )

PURPOSE: 配置串口

RETURN: 
	如果成功返回串口句柄, 否则返回NULL

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
HANDLE SetupCommPort()
{
	int myintPort;
    //
	//从设置对话框获取tty设置
    //
    UpdateTTYInfo();
	myintPort = atoi(gszPort+3);

    //
	//打开通信端口句柄
    //
	sprintf(gszPort, "\\\\.\\COM%d", myintPort);///可以显示COM10以上端口//add by itas109 2014-01-09
    g_appdata.hCommPort = CreateFile( gszPort,  
                                      GENERIC_READ | GENERIC_WRITE, 
                                      0, 
                                      0, 
                                      OPEN_EXISTING,
                                      FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED,
                                      0);

    if (g_appdata.hCommPort == INVALID_HANDLE_VALUE) {   
        ErrorReporter("CreateFile");
        return NULL;
    }

	//设置新的超时参数
    if (!GetCommTimeouts( g_appdata.hCommPort, &(g_appdata.timeoutsorig)))
        ErrorReporter("GetCommTimeouts");

    //
    // 重连COM口连接
    //
    UpdateConnection();

    //
    // 设置通信缓冲区大小
    //
    SetupComm(g_appdata.hCommPort, MAX_READ_BUFFER, MAX_WRITE_BUFFER);

    //
    // 将DT&线路升成高电位。
    // 参考后面注释
    if (!EscapeCommFunction(g_appdata.hCommPort, SETDTR))
        ErrorReporter("EscapeCommFunction (SETDTR)");

    //
    // 启动线程并将初始线程状态设置为not done
    //
    StartThreads();

	//设置连接标志
    g_appdata.fConnected = TRUE ;

    return g_appdata.hCommPort;
}

/*-----------------------------------------------------------------------------

FUNCTION: WaitForThreads(DWORD)

PURPOSE: 等待指定时间让工作线程退出

PARAMETERS:
    dwTimeout - 等待超时的毫秒数

RETURN:
    WAIT_OBJECT_0 - 成功等待，线程没有运行
    WAIT_TIMEOUT  - 至少有一个线程仍在运行
    WAIT_FAILED   - failure in WaitForMultipleObjects  参考文档末尾注释

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

----------------------------------------------------------------------------*/
DWORD WaitForThreads(DWORD dwTimeout)
{	
    HANDLE hThreads[2];
    DWORD  dwRes;

    hThreads[0] = g_appdata.hReaderStatus;
    hThreads[1] = g_appdata.hWriter;

    //
    // 设置线程终止句柄
    // 两个线程  读线程和写线程
    SetEvent(ghThreadExitEvent);
    dwRes = WaitForMultipleObjects(2, hThreads, TRUE, dwTimeout);
    switch(dwRes)
    {
        case WAIT_OBJECT_0:
        case WAIT_OBJECT_0 + 1: 
            dwRes = WAIT_OBJECT_0;
            break;

        case WAIT_TIMEOUT:
			//读线程
            if (WaitForSingleObject(g_appdata.hReaderStatus, 0) == WAIT_TIMEOUT)
                OutputDebugString("Reader/Status Thread didn't exit.\n\r");
			//写线程
            if (WaitForSingleObject(g_appdata.hWriter, 0) == WAIT_TIMEOUT)
                OutputDebugString("Writer Thread didn't exit.\n\r");
            break;

        default:
            ErrorReporter("WaitForMultipleObjects");
            break;
    }

    //
    // reset thread exit event here
    //
    ResetEvent(ghThreadExitEvent);

    return dwRes;
}

/*-----------------------------------------------------------------------------

FUNCTION: BreakDownCommPort

PURPOSE: 关闭对comm端口的连接

RETURN:
    TRUE  - 成功关闭港口
    FALSE - port isn't connected

COMMENTS: 等待线程退出，清除DTR，恢复通信端口超时，清除任何i/o并关闭所有相关句柄

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
BOOL BreakDownCommPort()
{
    if (!g_appdata.fConnected)
        return FALSE;

    g_appdata.fConnected = FALSE;

    //
    // 等待线程一小段时间
    //
    if (WaitForThreads(20000) != WAIT_OBJECT_0)
			//如果线程还没有退出，那么它们将退出 干扰一个新的连接。 必须中止 整个程序。
        ErrorHandler("Error closing port.");
    // 将DTR线路降成低电位。
    if (!EscapeCommFunction(g_appdata.hCommPort, CLRDTR))
        ErrorReporter("EscapeCommFunction(CLRDTR)");
    // restore original comm timeouts
    if (!SetCommTimeouts(g_appdata.hCommPort,  &(g_appdata.timeoutsorig)))
        ErrorReporter("SetCommTimeouts (Restoration to original)");
    // 清除读取/写入，输入缓冲区和输出缓冲区
    if (!PurgeComm(g_appdata.hCommPort, PURGE_FLAGS))
        ErrorReporter("PurgeComm");
    CloseHandle(g_appdata.hCommPort);
    CloseHandle(g_appdata.hReaderStatus);
    CloseHandle(g_appdata.hWriter);

    return TRUE;
}
 
/*-----------------------------------------------------------------------------

FUNCTION: DisconnectOK

PURPOSE: 询问用户是否可以断开连接

RETURN:
    TRUE  - OK to disconnect
    FALSE - Disconnect not OK

HISTORY:   Date:      Author:     Comment:
           10/27/95   AllenD      Wrote it

-----------------------------------------------------------------------------*/
BOOL DisconnectOK()
{
    if (!g_appdata.fConnected) return TRUE;
    return ((MessageBox(ghwndMain, "OK to Disconnect?", gszPort, MB_YESNO)) == IDYES);
}

/*-----------------------------------------------------------------------------
FUNCTION: QuerySingleSerialPortEx

PURPOSE: 查询指定端口状态
-----------------------------------------------------------------------------*/


BOOL QuerySingleSerialPortEx(int nPort)
{
	char strComm[50];
	BOOL bValid = TRUE;
	HANDLE hComm;
	int nError;


	sprintf(strComm,"COM%d",nPort);
	if (nPort >= 10)
	{//微软的技术手册规定打开端口号大于9的串口时应该使用"\\.\COM10"格式的文件名，更多的信息请参考msdn。
		sprintf(strComm,"\\\\.\\COM%d",nPort);
	}

	hComm = CreateFile(strComm,GENERIC_READ | GENERIC_WRITE,0,NULL,\
	OPEN_EXISTING,FILE_ATTRIBUTE_NORMAL| FILE_FLAG_OVERLAPPED, NULL); 
	nError = GetLastError();

	if(INVALID_HANDLE_VALUE == hComm)     
	{//***********如果没有该设备，或者被其他应用程序占用********
		if(2 == nError)
			bValid = -1;
		else if(5 == nError)
			bValid = FALSE;
		else
			bValid = FALSE;
	}
	CloseHandle(hComm); //重要 关闭文件句柄 = 关闭串口
	return bValid;
}


/*-----------------------------------------------------------------------------
FUNCTION: QuerySingleSerialPortEx

PURPOSE: 查询指定范围端口状态
利用API查询指定范围内的串口状态信息，并分别返回指定范围内系统存在的串口，
当前未被占用的可用串口，已被占用的串口和系统不存在的串口
*/

void QuerySerialPortStatusEx(int  *AryNoneOpenedPort,int nStartPort,int nLastPort)
{
	char strTmp[50],strComm[50],strFree[50];
	int n1 = nStartPort,n2=nLastPort,i,loop = 0;
	HANDLE hComm;
	int nLastError;
	//对输入的参数进行检查
	if(nStartPort < 1) nStartPort = 1;
	if(nStartPort > 65535) nStartPort = 65535;
	if(nLastPort < 1) nLastPort = 1;
	if(nLastPort > 65535) nLastPort = 65535;
	nStartPort = min(n1,n2);
	nLastPort  = max(n1,n2);
	memset(AryNoneOpenedPort,0,255);


	for (i = nStartPort;i<=nLastPort;i++)
	{
		sprintf(strComm,"COM%d",i);
		if (i >= 10)
		{//微软的技术手册规定打开端口号大于9的串口时应该使用"\\.\COM10"格式的文件名，更多的信息请参考msdn。
			sprintf(strComm,"\\\\.\\COM%d",i);
		}
		// 这里的CreateFile函数起了很大的作用，可以用来创建系统设备文件，如果该设备不存在或者被占用，则会返回一个错误，即下面的 INVALID_HANDLE_VALUE ，据此可以判断可使用性。详细参见MSDN中的介绍。
		hComm = CreateFile(strComm,GENERIC_READ | GENERIC_WRITE,0,NULL,\
			OPEN_EXISTING,FILE_ATTRIBUTE_NORMAL| FILE_FLAG_OVERLAPPED, NULL); 
		nLastError = GetLastError();
		//strComm.TrimLeft("\\\\.\\");

		if(hComm != INVALID_HANDLE_VALUE)     
		{//串口存在且未被占用
			AryNoneOpenedPort[loop] = i;
			loop++;
		}
		CloseHandle(hComm); //关闭文件句柄 - 必要
	}

}


/*
代码说明
EscapeCommFunction()函数
指示指定的通信设备执行扩展功能。
BOOL EscapeCommFunction(
  HANDLE hFile,  //通信设备的句柄 
  DWORD  dwFunc  //指定执行的功能
);
hFile：串行端口的Handle值，此值即为使用createFile函数后所返回的值。
dwFunc：指定串行端口必须完成的工作，由以下的常数数值组成：
CLRDTR：将DTR线路降成低电位。
CLRRTS：将RTS线路降成低电位
SETDTR：将DT&线路升成高电位。
SETRTS：RTS线路升成高电位
SETXOFF：当接收到Xoff字符时启动传输操作。
SETXON：当接收到Xon字符时启动传蝓作。
SETBREAK：没置道信状态为中断（送出Break信号）。
CLRBREAK：清除 Break信号，使传输动作继续。
请特别注意到上述的参数，包有DTR、RTS的线路控制指令，如果要个别地控制这两条线路的高低电位状态就需要硬用这个函数。



GetCommState()函数功能，使用指定通信设备的当前控制设置填充设备控制块（DCB结构）
BOOL GetCommState( HANDLE hFile, LPDCB lpDCB ); 
参数
hFile [in]由CreateFile函数返回的通信设备句柄。
lpDCB [out]指向返回控制设置数据的DCB结构的长指针。
typedef struct _DCB {        //DCB结构声明
    DWORD DCBlength;      DCB结构的长度      
    DWORD BaudRate;       当前波特率 
    DWORD fBinary: 1;     二进制模式，无EOF检查 
    DWORD fParity: 1;      激活奇偶校验检查    
    DWORD fOutxCtsFlow:1;  CTS输出流量控制     
    DWORD fOutxDsrFlow:1;  DSR输出流量控制  
    DWORD fDtrControl:2;   DTR流量控制类型  
    DWORD fDsrSensitivity:1;  DSR安全设置 
    DWORD fTXContinueOnXoff: 1;  XOFF持续Tx
    DWORD fOutX: 1;        XON/XOFF输出流量控制  
    DWORD fInX: 1;         XON/XOFF输出流量控制        
    DWORD fErrorChar: 1;   激活错误替换机制
    DWORD fNull: 1;        允许舍空格
    DWORD fRtsControl:2;   Rts流量控制
    DWORD fAbortOnError:1;  有错误时放弃读/写 
    DWORD fDummy2:17;      保留
    WORD wReserved;        现在不使用 
    WORD XonLim;           传送XON阀值 
    WORD XoffLim;          传送XOFF阀值
    BYTE ByteSize;         每个字节的位数 4-8        
    BYTE Parity;          校验 0-4=None,Odd,Even,Mark,Space    
    BYTE StopBits;         0,1,2 = 1, 1.5, 2               
    char XonChar;          设置Tx和Rx的XON的字符 
    char XoffChar;         设置Tx和Rx的XOFF字符       
    char ErrorChar;        有错误时的替换字符  
    char EofChar;          表示输入结束的字符 
    char EvtChar;          接收事件字符 
    WORD wReserved1;       保留未使用      
} DCB, *LPDCB;

DCB结构中重要参数说明如下：

Baudrate:串行端口的传输速度
fBinary:是否采用二进制方式发送数据，若设为1，表示采用二进制方式，占 一个位。由于win32只支持二进制的方式，故此值必须设置为1.
fParity:是否启动奇偶校验位检查，若设为1，表示采用奇偶校验位检查。此标志占一个位。
fOutxCtsFlow:是否采用CTS硬件流量控制。当此值设为1，而CTS引脚为底电位时，数据发送将暂停，直到CTS引脚升至高电位。占一个位。
fOutDsrFlow:是否采用DSR硬件流量控制。当此值设为1，而DSR引脚为低电位时，数据发送将暂停，直到DSR引脚升至高电位，占一个位。
fDtrControl:是否采用DTR硬件流量控制。可设为DTR_CONTROL_DISABLE（串行端口打开后设为低电位）、DTR_CONTROL_ENABLE（ 串行端口打开后设为高电位）DTR_CONTROL_HANDSHAKE（启动硬件流量控制）三者之一，其常数定义数值分别是0、1、2。此标志占两个位。
fDsrSensitivity：当成True时，当DSR引脚被提升至高电位之前，串行端口将忽略任何被收到的数据。此标志占一个位的位置。
ftOutX：发送过程是否启用软件握手（XON_XOFF）。当设成1时，发送过程收到XOFF字符时停上发送，而收到XON字符时恢复发送。此标志占一个位的位置。
fInX：发送过程是否后用软件握手(XON-XOFF),当设成1时，接收过程若超过设置值（XoffLim参数决定），则送出XOFF字符：而低于设置值时（Xonlim参数决定）送出XON字符。此标志占一个位的位置。
fNuil:接收过程是否舍弃空格符。若设成1则于接收过程将自动去掉空格符。此标志占一个位的位置。
fRtsControl:是否启动RTS硬件流控制。可设为RTS_CONTROL_DISABLE（串行端凵打丌后设为低电位）、RTS_CONTROL_ENABLE（串行端口打开后设为高电位）、RTS_CONTROL_HANDSHAKE（启动硬件流量控制）、
RTSCONTROLTOGGLE（指示发过程的进行状态）四者之一，其常数是0、1、2、3。此标志占两个位的位置。
XonLim:设置发送XON字符时，输入缓冲区中的最小字节数
XoffLim:设置发送XOFF字符时，输入缓冲区中的最大字节数
ByteSize:设置数据位数。有5、6、7、8可以设置。
Parity:设置校验位检查的种类。有None、Even、Odd三种
StopBits:设置停止位数。有1、1.5、2三种
XonChar:设置XON字符
XoffChar:设置XOFF字符


SetCommState()函数
SetCommState()函数设置串行端口状态。如设置串口设置(波特率,校验,停止位,数据位等).
SetCommState()函数原型：
BOOL SetCommState( HANDLE hFile, LPDCB lpDCB );
hFile:串行端口的Handle值，此值即为使用CreateFile函数后返回的值。
lpDCB:设备控制块（Device Control Block, DCB)结构，将指定后的DCB结构传入。


WriteFile()函数
WriteFile函数，可以将数据写入一个文件或者I/O设备。该函数比fwrite函数要灵活的多，也可将这个函数应用于对通信设备、管道、套接字以及邮槽的处理。
windows将串行端口当成文件来使用，因此写入串行端口数据的函数也是WriteFile。 
WriteFile()函数原型：
BOOL WriteFile( HANDLE  hFile,//文件句柄
               LPCVOID lpBuffer,//数据缓存区指针
               DWORD   nNumberOfBytesToWrite,//要写的字节数
               LPDWORD lpNumberOfBytesWritten,//用于保存实际写入字节数的存储区域的指针
               LPOVERLAPPED lpOverlapped//OVERLAPPED结构体指针
);
hFile:串行端口的Handle值，句柄
lpBuffer:指向欲发送的数据
nNumberOfBytesToWrite:写入的字节数
lpNumberOfBytesWritten:指向被写入的字节数的变量地址
lpOverlapped:指向overlapped I/O的结构地址，通常用来作背景工作时同步检查用，在串行通信中若不使用异步传输，则可不使用，设成NULL即可。


ReadFile()函数
从文件中读出数据。与fread函数相比，这个函数要明显灵活的多。该函数能够操作通信设备、管道、套接字以及邮槽。
windows将串行端口的使用当成文件，因此读取串行端口数据的函数亦使用读文件函数ReadFile.
ReadFile()函数原型：
BOOL ReadFile(
    HANDLE hFile, //文件的句柄
    LPVOID lpBuffer, //接收数据的缓冲区
    DWORD nNumberOfBytesToRead,    //读取的字节数
    LPDWORD lpNumberOfBytesRead,    //指向实际读取字节数的指针
    LPOVERLAPPED lpOverlapped
    //如文件打开时指定了FILE_FLAG_OVERLAPPED，那么必须，用这个参数引用一个特殊的结构。
    //该结构定义了一次异步读取操作。否则，应将这个参数设为NULL
);
ReadFile()函数参数说明：
hFile:串行端口的Handle值，
lpBuffer:指向存储被读取数据的地址
nNumberOfBytesToRead:准备读取的数据字节数
lpNumberOfBytesRead:准备读取字节数的指针
lpOverlapped:指向overlapped I/O的结构地址，在串行通信中若不同时进行后台工作，则可不使用，设成NULL即可。


ClearCommError()函数
清除串行端口错误或读取串行端口现在的状态时，可用函数ClearCommError。Windows系统利用此函数清除硬件的通讯错误以及获取通讯设备的当前状态
ClearCommError()函数原型
BOOL ClearCommError( HANDLE hFile,   //通信设备的句柄
                    LPDWORD lpErrors,//接收错误代码变量的指针
                    LPCOMSTAT lpStat  //通信状态缓冲区的指针
);
ClearCommError()函数参数说明：
hFile：串行端冂的Handle值，此值即为使用CreateFile函数后所返回的值。
lpError：返回错误数值，错误常数如下：
CE_BREAK：检测到中断信号。
CE_DNS：Windows95专用，未被选择的并行端口。
CE_FRAME：硬件检到框架错误
CE_IOE：通信设备发生输入／输出綹误，
CE_MODE：设置模式错误，或是hFile值错误。
CE_OOP：Wmdows95专用，并行端口发生缺纸错误。CE_OVERRUN：缓冲区容量不足，数据将遗失。
CE_PTO：Windows95专用，并行端口发生超时错误。
CE_RXOVER：接收区满溢或在文件结尾被接收到后仍有数据发送过来。
CE_RXPARITY：硬件检测到校验位检查错误。
CE_TXFULL：发送缓存区已满后，应用程序仍要发送数据。
lpStat:指向通信端口状态的结构变量。此结构的原始声明如下：
typedef struct _COMSTAT {  //cst
    DWORD fCtsHold : 1;  //Tx正在等待CTS信号  
    DWORD fDsrHold : 1;  //Tx正在等待DSR信号
    DWORD fRlsdHold : 1; //Tx正在等待RLSD信号
    DWORD fXoffHold : 1;  //Tx由于接收XOFF字符而在等待
    DWORD fXoffSent : 1;   //Tx由于发送XOFF字符而在等待
    DWORD fEof : 1;      //发送EOF字符
    DWORD fTxim : 1;     //字符在等待Tx
    DWORD fReserved : 25;   //保留
    DWORD cbInQue;    //输入缓冲区中的字节数
    DWORD cbOutQue;     //输出缓冲区中的字节数
} COMSTAT, *LPCOMSTAT;
此结构屮有关参数说明如下：
fCtsHold：是否正在等待CTS信号。占一个位的位置。
fDsrHold：是否正在等待DSR信号。占一个位的位置。
fRlsdHoId：是否正在等待RLSD信号。占一个位的位置。
fXoftHoId：是否因收到xoff字符而在等待。占一个位的位置。
fXoffHold：是否因送出xoff字符而使得发送的动作在等待。占一个位置
cbInQue：在输入缓冲区尚未被ReadFile函数读取的数据字节数。这个参数经常被用来进行状态检查。
cbOutQue：在发送缓冲区而尚未被发送的据字节数


WaitForMultipleObjects   是Windows中的一个功能非常强大的函数，几乎可以等待Windows中的所有的内核对象

PurgeComm()函数
PurgeComm()函数–清空缓冲区
BOOL PurgeComm( HANDLE hFile, DWORD dwFlags );
hFile
[in]处理通信资源。该的CreateFile函数返回该句柄。
dwFlags
[in]指定要采取的操作。下表显示了可能的值。
PURGE_TXABORT 终止所有正在进行的字符输出操作,完成一个正处于等待状态的重叠i/o操作,他将产生一个事件,指明完成了写操作
PURGE_RXCLEAR  终止所有正在进行的字符输入操作,完成一个正在进行中的重叠i/o操作,并带有已设置得适当事件
PURGE_TXABORT  这个命令指导设备驱动程序清除输出缓冲区，经常与PURGE_TXABORT 命令标志一起使用
PURGE_RXCLEAR 这个命令用于设备驱动程序清除输入缓冲区，经常与PURGE_RXABORT 命令标志一起使用







*/