3、讀寫串口

　　我們使用ReadFile和WriteFile讀寫串口，下面是兩個函數的聲明：

　　BOOL ReadFile（ HANDLE hFile， //串口的句柄

　　// 讀入的數據存儲的地址，

　　// 即讀入的數據將存儲在以該指針的值為首地址的一片內存區

　　LPVOID lpBuffer，

　　// 要讀入的數據的字節數

　　DWORD nNumberOfBytesToRead，

　　// 指向一個DWORD數值，該數值返回讀操作實際讀入的字節數

　　LPDWORD lpNumberOfBytesRead，

　　// 重疊操作時，該參數指向一個OVERLAPPED結構，同步操作時，該參數為NULL。

　　LPOVERLAPPED lpOverlapped ）;

　　BOOL WriteFile（ HANDLE hFile， //串口的句柄

　　// 寫入的數據存儲的地址，

　　// 即以該指針的值為首地址的

　　LPCVOID lpBuffer，

　　//要寫入的數據的字節數

　　DWORD nNumberOfBytesToWrite，

　　// 指向指向一個DWORD數值，該數值返回實際寫入的字節數

　　LPDWORD lpNumberOfBytesWritten，

　　// 重疊操作時，該參數指向一個OVERLAPPED結構，

　　// 同步操作時，該參數為NULL。

　　LPOVERLAPPED lpOverlapped ）;

　　在用ReadFile和WriteFile讀寫串口時，既可以同步執行，也可以重疊執行。在同步執行時，函數直到操作完成后才返回。這意味著同步執行時線程會被阻塞，從而導致效率下降。在重疊執行時，即使操作還未完成，這兩個函數也會立即返回，費時的I/O操作在后臺進行。

　　ReadFile和WriteFile函數是同步還是異步由CreateFile函數決定，如果在調用CreateFile創建句柄時指定了FILE_FLAG_OVERLAPPED標志，那么調用ReadFile和WriteFile對該句柄進行的操作就應該是重疊的；如果未指定重疊標志，則讀寫操作應該是同步的。ReadFile和WriteFile函數的同步或者異步應該和CreateFile函數相一致。

　　ReadFile函數只要在串口輸入緩沖區中讀入指定數量的字符，就算完成操作。而WriteFile函數不但要把指定數量的字符拷入到輸出緩沖區，而且要等這些字符從串行口送出去后才算完成操作。

　　如果操作成功，這兩個函數都返回TRUE。需要注意的是，當ReadFile和WriteFile返回FALSE時，不一定就是操作失敗，線程應該調用GetLastError函數分析返回的結果。例如，在重疊操作時如果操作還未完成函數就返回，那么函數就返回FALSE，而且GetLastError函數返回ERROR_IO_PENDING。這說明重疊操作還未完成。

　　同步方式讀寫串口比較簡單，下面先例舉同步方式讀寫串口的代碼：

　　//同步讀串口

　　char str［100］;

　　DWORD wCount;//讀取的字節數

　　BOOL bReadStat;

　　bReadStat=ReadFile（hCom，str，100，&wCount，NULL）;

　　if（！bReadStat） { AfxMessageBox（“讀串口失敗！”）; return FALSE; } return TRUE; //同步寫串口

　　char lpOutBuffer［100］;

　　DWORD dwBytesWrite=100;

　　COMSTAT ComStat;

　　DWORD dwErrorFlags;

　　BOOL bWriteStat;

　　ClearCommError（hCom，&dwErrorFlags，&ComStat）;

　　bWriteStat=WriteFile（hCom，lpOutBuffer，dwBytesWrite，& dwBytesWrite，NULL）;

　　if（！bWriteStat） { AfxMessageBox（“寫串口失敗！”）; }

　　PurgeComm（hCom， PURGE_TXABORT| PURGE_RXABORT|PURGE_TXCLEAR|PURGE_RXCLEAR）;

　　在重疊操作時，操作還未完成函數就返回。

　　重疊I/O非常靈活，它也可以實現阻塞（例如我們可以設置一定要讀取到一個數據才能進行到下一步操作）。有兩種方法可以等待操作完成：一種方法是用象WaitForSingleObject這樣的等待函數來等待OVERLAPPED結構的hEvent成員；另一種方法是調用GetOverlappedResult函數等待，后面將演示說明。

　　下面我們先簡單說一下OVERLAPPED結構和GetOverlappedResult函數：

　　OVERLAPPED結構

　　OVERLAPPED結構包含了重疊I/O的一些信息，定義如下：

　　typedef struct _OVERLAPPED { // o

　　DWORD Internal;

　　DWORD InternalHigh;

　　DWORD Offset;

　　DWORD OffsetHigh;

　　HANDLE hEvent;

　　} OVERLAPPED;

　　在使用ReadFile和WriteFile重疊操作時，線程需要創建OVERLAPPED結構以供這兩個函數使用。線程通過OVERLAPPED結構獲得當前的操作狀態，該結構最重要的成員是hEvent。hEvent是讀寫事件。當串口使用異步通訊時，函數返回時操作可能還沒有完成，程序可以通過檢查該事件得知是否讀寫完畢。

　　當調用ReadFile， WriteFile 函數的時候，該成員會自動被置為無信號狀態；當重疊操作完成后，該成員變量會自動被置為有信號狀態。

　　GetOverlappedResult函數 BOOL GetOverlappedResult（ HANDLE hFile， // 串口的句柄 // 指向重疊操作開始時指定的OVERLAPPED結構 LPOVERLAPPED lpOverlapped， // 指向一個32位變量，該變量的值返回實際讀寫操作傳輸的字節數。 LPDWORD lpNumberOfBytesTransferred， // 該參數用于指定函數是否一直等到重疊操作結束。 // 如果該參數為TRUE，函數直到操作結束才返回。 // 如果該參數為FALSE，函數直接返回，這時如果操作沒有完成， // 通過調用GetLastError（）函數會返回ERROR_IO_INCOMPLETE。 BOOL bWait ）;

　　該函數返回重疊操作的結果，用來判斷異步操作是否完成，它是通過判斷OVERLAPPED結構中的hEvent是否被置位來實現的。

　　異步讀串口的示例代碼：

　　char lpInBuffer［1024］;

　　DWORD dwBytesRead=1024;

　　COMSTAT ComStat;

　　DWORD dwErrorFlags;

　　OVERLAPPED m_osRead;

　　memset（&m_osRead，0，sizeof（OVERLAPPED））;

　　m_osRead.hEvent=CreateEvent（NULL，TRUE，FALSE，NULL）;

　　ClearCommError（hCom，&dwErrorFlags，&ComStat）;

　　dwBytesRead=min（dwBytesRead，（DWORD）ComStat.cbInQue）;

　　if（！dwBytesRead） return FALSE;

　　BOOL bReadStatus;

　　bReadStatus=ReadFile（hCom，lpInBuffer， dwBytesRead，&dwBytesRead，&m_osRead）;

　　if（！bReadStatus）

　　//如果ReadFile函數返回FALSE

　　{

　　if（GetLastError（）==ERROR_IO_PENDING）

　　//GetLastError（）函數返回ERROR_IO_PENDING，表明串口正在進行讀操作

　　{

　　WaitForSingleObject（m_osRead.hEvent，2000）;

　　//使用WaitForSingleObject函數等待，直到讀操作完成或延時已達到2秒鐘

　　//當串口讀操作進行完畢后，m_osRead的hEvent事件會變為有信號

　　PurgeComm（hCom， PURGE_TXABORT| PURGE_RXABORT|PURGE_TXCLEAR|PURGE_RXCLEAR）;

　　return dwBytesRead;

　　}

　　return 0;

　　}

　　PurgeComm（hCom， PURGE_TXABORT| PURGE_RXABORT|PURGE_TXCLEAR|PURGE_RXCLEAR）;

　　return dwBytesRead;

　　對以上代碼再作簡要說明：

　　在使用ReadFile 函數進行讀操作前，應先使用ClearCommError函數清除錯誤。

　　ClearCommError函數的原型如下：

　　BOOL ClearCommError（ HANDLE hFile， // 串口句柄

　　LPDWORD lpErrors， // 指向接收錯誤碼的變量

　　LPCOMSTAT lpStat // 指向通訊狀態緩沖區 ）;

　　該函數獲得通信錯誤并報告串口的當前狀態，同時，該函數清除串口的錯誤標志以便繼續輸入、輸出操作。

　　參數lpStat指向一個COMSTAT結構，該結構返回串口狀態信息。

　　COMSTAT結構 COMSTAT結構包含串口的信息，結構定義如下：

　　typedef struct _COMSTAT { // cst DWORD fCtsHold ： 1; // Tx waiting for CTS signal DWORD fDsrHold ： 1; // Tx waiting for DSR signal DWORD fRlsdHold ： 1; // Tx waiting for RLSD signal DWORD fXoffHold ： 1; // Tx waiting， XOFF char rec‘’d DWORD fXoffSent ： 1; // Tx waiting， XOFF char sent DWORD fEof ： 1; // EOF character sent DWORD fTxim ： 1; // character waiting for Tx DWORD fReserved ： 25; // reserved DWORD cbInQue; // bytes in input buffer DWORD cbOutQue; // bytes in output buffer } COMSTAT， *LPCOMSTAT;

　　本文只用到了cbInQue成員變量，該成員變量的值代表輸入緩沖區的字節數。

　　最后用PurgeComm函數清空串口的輸入輸出緩沖區。

　　這段代碼用WaitForSingleObject函數來等待OVERLAPPED結構的hEvent成員，下面我們再演示一段調用GetOverlappedResult函數等待的異步讀串口示例代碼：

　　char lpInBuffer［1024］;

　　DWORD dwBytesRead=1024;

　　BOOL bReadStatus;

　　DWORD dwErrorFlags;

　　COMSTAT ComStat;

　　OVERLAPPED m_osRead;

　　ClearCommError（hCom，&dwErrorFlags，&ComStat）;

　　if（！ComStat.cbInQue） return 0;

　　dwBytesRead=min（dwBytesRead，（DWORD）ComStat.cbInQue）;