MSComm控制元件

　　Visual C++為我們提供了一種好用的ActiveX控制元件Microsoft Communications Control(即MSComm)來支援應用程式對串列埠的訪問，在應用程式中插入MSComm控制元件後就可以較為方便地實現對通過計算機串列埠收發資料。

　　要使用ActiveX控制元件MSComm，程式設計師必須將其新增入工程，其方法是：

　　（1）單擊主選單project的子選單Add To project的Components and Controls選項；

　　（2）在彈出的"Components and Controls Gallery"對話方塊中選擇Registered ActiveX Controls資料夾中的"Microsoft Communications Control,version 6.0"選項，如下圖：

　　單擊其中的"Insert"按鈕，MSComm控制元件就被增加到工程中了。與此同時，類CMSComm的相關檔案mscomm.h和mscomm.cpp也一併被加入Project的Header Files和Source Files中。當然，程式設計師可以自己修改檔名，如下圖：

　　直接分析mscomm.h標頭檔案就可以完備地獲取這個控制元件的使用方法（主要是public型別的介面函式），下面我們摘取了標頭檔案的主要程式碼並對其關鍵部分給出了註釋：

　　分析上述原始碼可知，基本上，MSComm的諸多介面可以分為如下幾類：

　　（1）開啟與設定串列埠介面函式；

　　（2）獲得串列埠設定和串列埠狀態介面函式；

　　（3）設定串列埠傳送資料方式、緩衝區介面及傳送資料介面函式；

　　（4）設定串列埠接收資料方式、緩衝區介面及接收資料介面函式；

　　（5）設定與獲取串列埠上發生的事件介面函式。

摘要：本文介紹了在Microsoft Visual C++ 6.0環境下通過對Active X控制元件的程式設計來實現串列埠的通訊的一般方法。

　　一、 引言

　　當我們在Windows作業系統下開發序列通訊程式時通常不得不面對許多複雜的API函式，因為在Windows作業系統下不能直接對裝置埠進行操作，也不能在系統級（Ring 3級別）使用任何DOS或BIOS中斷，如要對埠進行程式設計則只能以檔案的形式來對埠進行操作，這就使開發人員不得不面對非常煩瑣的API函式程式設計。本文對此提出了另外一種封裝性很好的使用Microsoft Visual C++ 6.0自帶的"Microsoft Communications Control，version 6.0"Active X控制元件的程式設計方法，通過對該控制元件的正確使用，我們可以比較輕鬆地編寫出所需的序列通訊程式。

　　下面，我們將結合一個實際的程式示例來對此方法進行說明。本程式的程式設計環境是Windows 98和Microsoft Visual C++ 6.0。在本程式示例中對為避免阻塞而對執行緒的使用以及在使用中遇到的一些問題也做了詳細的介紹。

　　二、 程式的設計實現

　　在開始進行程式碼程式設計前，首先以在工程中插入元件或控制元件的方式將Active X控制元件"Microsoft Communications Control，version 6.0"加入到工程中來，此時將會在工程中新增一個關於此控制元件的新類。使用該控制元件的一些方法和屬性時不能象使用類一樣簡單的宣告一個例項物件，而要通ClassWizard為該控制元件和一個成員變數建立起繫結關係，在此我們將該控制元件同變數m_Comm相繫結後就可以通過該控制元件提供的方法來對串列埠的各種通訊引數進行設定了。為了程式設計方便起見，也可以在資源檢視中直接對該控制元件的屬性進行設定，如無特別要求，對下表所列屬性進行設定就基本可以滿足程式設計要求了。現將常用的屬性列表如下：

屬性 設定值 屬性說明
CommPort  1  串列埠號，一般從1到4
InBufferSize 30720 接收緩衝區大小，為保持程式的穩定，建議設得值足夠大
InputMode 0-Text  接收資料的型別，0表示文字型別，1表示二進位制型別
InputLen 0  從接收緩衝區讀取的位元組數，0表示全部讀取 
OutBufferSize 512  傳送緩衝區大小
Settings  4800,n,8,1 串列埠的引數設定,依次為波特率、奇偶校驗(n-無校驗,e-偶校驗,o-奇校驗)、資料位數、停止位數
RThreshold 1  設定當接收幾個字元時觸發OnComm事件，0表示不產生事件，
1表示每接收一個字元就產生一個事件 
SThreshold  0  設定在觸發OnComm事件前，傳送緩衝區內所允許的最少的字元數，
0表示傳送資料時不產生事件，1表示當傳送緩衝區空時產生OnComm事件

　　我們要求能在程式啟動的同時就開啟串列埠以便即時對從串列埠到達的資料進行接收、處理。一般來說可以將下面的開啟埠的程式碼寫在OnCreate()、OnInitialUpdate()、InitInstance ()等程式入口函式中：

……
if(!m_Comm.GetPortOpen()) //檢測是否已經開啟過埠
m_Comm.SetPortOpen(TRUE); //如沒有開啟則將埠開啟
 

接下來的工作就是對資料的傳送與接收了，這也是本文所要介紹的重點所在。傳送資料的程式碼原則上是可以寫到一個成員函式中被直接呼叫的，但這並不是一個良好的程式設計習慣：我們應當把比較耗時的操作，如檔案拷貝、列印、埠傳輸等工作放到一個單獨的執行緒當中，以避免其在工作時會引起整個程序的阻塞，以提高整個系統對CPU的利用率。例如我們可以在視類中選單或按鈕的響應函式中用AfxBeginThread(WriteProc,this)函式來開啟一個名為"WriteProc"的執行緒，由於線上程中還需要使用視類的函式和變數，為了不產生新的視類的例項物件，我們通過該函式的第二個引數將指向當前的視類的指標this作為引數傳遞給執行緒。線上程中可以用如下兩種方法之中的一種呼叫視類的成員函式：

((COLECommView*) pParam)->DoSendProc();

　　或是：

COLECommView* view=(COLECommView*) pParam;
View->DoSendProc();
 

　　其中從pParam傳來的變數就是指向視類的指標。線上程中通過呼叫視類中的DoSendProc函式來完成對資料的傳送，正是由於該函式是被全域性的執行緒所呼叫的，我們就不可以使用取編輯框上的資料時通常所用的UpdateData()函數了，取而帶之的是API 函式GetDlgItemText()，取到輸入的資料後通過控制元件的SetOutput() 方法就把資料從串列埠發出去了，其中傳送資料必須經ColeVariant類將其轉換為通用的VARIANT型變數。實現
主要程式碼如下：

……
char a[255];
HWND hwnd=GetSafeHwnd();
::GetDlgItemText(hwnd,IDC_EDIT1,a,255);
int i=0;
CString str;
while(a[i]!='\0')
{
str.Format("%c",a[i]);
m_SendData+=str;
i++;
}
str.Format("%c",10);
m_SendData+=str;
m_Comm.SetOutput(COleVariant(m_SendData));
……

　　至於資料的接收，我們可以通過讓MS Comm控制元件響應其OnComm事件來完成，通過ClassWizard加入其對事件的響應後，通過下面的事件對映，當有字元到達時便會通知 OnComm()函式去處理，從而實現資料的非同步接收：

……
BEGIN_EVENTSINK_MAP(COLECommView, CFormView)
//{{AFX_EVENTSINK_MAP(COLECommView)
ON_EVENT(COLECommView, IDC_MSCOMM1, 1 /* OnComm */, OnComm, VTS_NONE)
//}}AFX_EVENTSINK_MAP
END_EVENTSINK_MAP()
……
void COLECommView::OnComm()
{
VARIANT Input;
if(m_Comm.GetCommEvent()==2)//接收緩衝區內有字元
{
Input=m_Comm.GetInput();//讀取緩衝區內的資料
CString msg=Input.bstrVal;
CString str;
str.Format("%c",10);
if(msg.Right(1)==str)
{
m_RecvData+=msg;
m_History.AddString(m_RecvData);
m_RecvData="";
}
else
m_RecvData+=msg;
}
}
 

　　當資料被接收到接收緩衝區後，對於字元可以從VARIANT型結構變數的bstrVal成員變數中獲取，VARIANT資料結構相當複雜，並牽扯到COM(Component Object Model，元件物件模型)中的一些概念，具體詳情請參閱Microsoft Corpration釋出的MSDN中的有關論述。

　　三、 測試與實驗

　　編譯執行程式之前有必要對機器的埠做一番檢查，以確保埠的完好，可以用常見的DOS程式Comdebug來檢查。在確認串列埠工作正常後，可用串列埠線將兩臺機器的串列埠相連，同時在兩臺機子上執行該程式，如果沒有條件也可只用一臺微機，將其串列埠的2腳和3腳短接，使其處於自發自收狀態。經過資料的傳輸實驗證明該程式是可靠、正確的。

　　小結：利用通訊控制元件可以很容易的編寫出序列通訊程式。但相對來說通訊控制元件在VC中的使用要比在VB、Delphi中複雜的多，要想對串列埠通訊開發出更多更靈活的使用方法還需要不斷的實踐中摸索。本程式在
Windows 98下，由Microsoft Visual C++ 6.0編譯通過。