MSComm串列埠控制元件使用詳解（轉）

所屬類別：VC++

文章作者：龔建偉

釋出日期：2006-10-16

摘要：本文詳細介紹了MSComm控制元件在串列埠程式設計中的使用。

     MSComm 控制元件通過串列埠傳輸和接收資料，為應用程式提供序列通訊功能。MSComm控制元件在串列埠程式設計時非常方便，程式員不必去花時間去了解較為複雜的API函式，而且在VC、VB、Delphi等語言中均可使用。 Microsoft Communications Control（以下簡稱MSComm）是Microsoft公司提供的簡化Windows下序列通訊程式設計的ActiveX控制元件，它為應用程式提供了通過序列介面收發資料的簡便方法。具體的來說，它提供了兩種處理通訊問題的方法：一是事件驅動(Event－driven)方法，一是查詢法。

控制元件兩種處理通訊的方式">1.MSComm控制元件兩種處理通訊的方式

MSComm控制元件提供下列兩種處理通訊的方式：事件驅動方式和查詢方式。 
1.1 事件驅動方式

事件驅動通訊是處理串列埠互動作用的一種非常有效的方法。在許多情況下，在事件發生時需要得到通知，例如，在串列埠接收緩衝區中有字元，或者 Carrier Detect (CD) 或 Request To Send (RTS) 線上一個字元到達或一個變化發生時。在這些情況下，可以利用 MSComm 控制元件的 OnComm 事件捕獲並處理這些通訊事件。OnComm 事件還可以檢查和處理通訊錯誤。所有通訊事件和通訊錯誤的列表，參閱 CommEvent 屬性。在程式設計過程中，就可以在OnComm事件處理函式中加入自己的處理程式碼。這種方法的優點是程式響應及時，可靠性高。每個MSComm 控制元件對應著一個串列埠。如果應用程式需要訪問多個串列埠，必須使用多個 MSComm 控制元件。

1.2 查詢方式

查詢方式實質上還是事件驅動，但在有些情況下，這種方式顯得更為便捷。在程式的每個關鍵功能之後，可以通過檢查 CommEvent 屬性的值來查詢事件和錯誤。如果應用程式較小，並且是自保持的，這種方法可能是更可取的。例如，如果寫一個簡單的電話撥號程式，則沒有必要對每接收一個字元都產生事件，因為唯一等待接收的字元是調變解調器的“確定”響應。

2.MSComm 控制元件的常用屬性
MSComm 控制元件有很多重要的屬性，但首先必須熟悉幾個屬性。
CommPort 設定並返回通訊埠號。 
Settings 以字串的形式設定並返回波特率、奇偶校驗、資料位、停止位。 
PortOpen 設定並返回通訊埠的狀態。也可以開啟和關閉埠。 
Input 從接收緩衝區返回和刪除字元。 
Output 向傳輸緩衝區寫一個字串。
下面分別描述： 
CommPort屬性 設定並返回通訊埠號。
語法 object.CommPort[value ] (value 一整型值，說明埠號。) 
說明 在設計時，value 可以設定成從 1 到 16 的任何數（預設值為 1）。但是如果用 PortOpen 屬性開啟一個並不存在的埠時，MSComm 控制元件會產生錯誤 68（裝置無效）。
注意：必須在開啟埠之前設定 CommPort 屬性。
RThreshold 屬性：在 MSComm 控制元件設定 CommEvent 屬性為 comEvReceive 併產生 OnComm 之前，設定並返回的要接收的字元數。
語法 object.Rthreshold [ = value ]（value 整型表示式，說明在產生 OnComm 事件之前要接收的字元數。 ）
說明 當接收字元後，若 Rthreshold 屬性設定為 0（預設值）則不產生 OnComm 事件。例如，設定 Rthreshold 為 1，接收緩衝區收到每一個字元都會使 MSComm 控制元件產生 OnComm 事件。
CTSHolding 屬性：確定是否可通過查詢 Clear To Send (CTS) 線的狀態傳送資料。Clear To Send 是調變解調器傳送到相聯計算機的訊號，指示傳輸可以進行。該屬性在設計時無效，在執行時為只讀。
語法： object.CTSHolding（Boolean）
Mscomm 控制元件的 CTSHolding 屬性設定值：
True Clear To Send 線為高電平。 
False Clear To Send 線為低電平。 
說明：如果 Clear To Send 線為低電平 (CTSHolding = False) 並且超時時，MSComm 控制元件設定 CommEvent 屬性為 comEventCTSTO (Clear To Send Timeout) 併產生 OnComm 事件。
Clear To Send 線用於 RTS/CTS (Request To Send/Clear To Send) 硬體握手。如果需要確定 Clear To Send 線的狀態，CTSHolding 屬性給出一種手工查詢的方法。
詳細資訊 有關握手協議，請參閱 Handshaking 屬性。
SThreshold 屬性： MSComm 控制元件設定 CommEvent 屬性為 comEvSend 併產生 OnComm 事件之前，設定並返回傳輸緩衝區中允許的最小字元數。
語法 object.SThreshold [ = value ]
value 整形表示式，代表在 OnComm 事件產生之前在傳輸緩衝區中的最小字元數。 
說明：若設定 Sthreshold 屬性為 0（預設值），資料傳輸事件不會產生 OnComm 事件。若設定 Sthreshold 屬性為 1，當傳輸緩衝區完全空時，MSComm 控制元件產生 OnComm 事件。如果在傳輸緩衝區中的字元數小於 value，CommEvent 屬性設定為 comEvSend，併產生 OnComm 事件。comEvSend 事件僅當字元數與 Sthreshold 交叉時被啟用一次。例如，如果 Sthreshold 等於 5，僅當在輸出佇列中字元數從 5 降到 4 時，comEvSend 才發生。如果在輸出佇列中從沒有比 Sthreshold 多的字元，comEvSend 事件將絕不會發生。
Handshake 常數

常數 值 描述 
comNone 0 無握手。 
comXonXoff 1 XOn/Xoff 握手。 
comRTS 2 Request-to-send/clear-to-send 握手。 
comRTSXOnXOff 3 Request-to-send 和 clear-to-send 握手皆可。 
OnComm 常數

常數 值 描述 
comEvSend 1 傳送事件。 
comEvReceive 2 接收事件。 
comEvCTS 3 clear-to-send 線變化。 
comEvDSR 4 data-set ready 線變化。 
comEvCD 5 carrier detect 線變化。 
comEvRing 6 振鈴檢測。 
comEvEOF 7 檔案結束。 
Error 常數

常數 值 描述 
comEventBreak 1001 接收到中斷訊號 
comEventCTSTO 1002 Clear-to-send 超時 
comEventDSRTO 1003 Data-set ready 超時 
comEventFrame 1004 幀錯誤 
comEventOverrun 1006 埠超速 
comEventCDTO 1007 Carrier detect 超時 
comEventRxOver 1008 接收緩衝區溢位 
comEventRxParity 1009 Parity 錯誤 
comEventTxFull 1010 傳輸緩衝區滿 
comEventDCB 1011 檢索埠 裝置控制塊 (DCB) 時的意外錯誤 
InputMode 常數
常數 值 描述 
comInputModeText 0 （預設）通過 Input 屬性以文字方式取回資料。 
comInputModeBinary 1 通過 Input 屬性以二進位制方式檢取回資料。 
CDHolding 屬性：通過查詢 Carrier Detect (CD) 線的狀態確定當前是否有傳輸。Carrier Detect 是從調變解調器傳送到相聯計算機的一個訊號，指示調變解調器正在聯機。該屬性在設計時無效，在執行時為只讀。
語法 object.CDHolding
設定值：CDHolding 屬性的設定值為： 
設定 描述 
True Carrier Detect 線為高電平 
False Carrier Detect 線為低電平 
說明：注意當 Carrier Detect 線為高電平 (CDHolding = True) 且超時時，MSComm 控制元件設定CommEvent 屬性為 comEventCDTO（Carrier Detect 超時錯誤），併產生 OnComm 事件。
注意 在主機應用程式中捕獲一個丟失的傳輸是特別重要的，例如一個公告板，因為呼叫者可以隨時掛起（放棄傳輸）。
Carrier Detect 也被稱為 Receive Line Signal Detect (RLSD)。
資料型別 Boolean
DSRHolding 屬性：確定 Data Set Ready (DSR) 線的狀態。Data Set Ready 訊號由調變解調器傳送到相連計算機，指示作好操作準備。該屬性在設計時無效，在執行時為只讀。
語法：object.DSRHolding
object 所在處表示物件表示式，其值是“應用於”列表中的物件。
DSRHolding 屬性返回以下值：
值 描述 
True Data Set Ready 線高 
False Data Set Ready 線低 
說明：當 Data Set Ready 線為高電平 (DSRHolding = True) 且超時時，MSComm 控制元件設定 CommEvent 屬性為 comEventDSRTO（資料準備超時）併產生 OnComm 事件。
當為 Data Terminal Equipment (DTE) 機器寫 Data Set Ready/Data Terminal Ready 握手例程時該屬性是十分有用的。
資料型別：Boolean
Settings 屬性: 設定並返回波特率、奇偶校驗、資料位、停止位引數。
語法: object.Settings[ = value]
說明：當埠開啟時，如果 value 非法，則 MSComm 控制元件產生錯誤 380（非法屬性值）。
Value 由四個設定值組成，有如下的格式：
"BBBB,P,D,S"
BBBB 為波特率，P 為奇偶校驗，D 為資料位數，S 為停止位數。value 的預設值是：
"9600,N,8,1"
InputLen 屬性：設定並返回 Input 屬性從接收緩衝區讀取的字元數。
語法 object.InputLen [ = value]
InputLen 屬性語法包括下列部分：
value 整型表示式，說明 Input 屬性從接收緩衝區中讀取的字元數。 
說明：InputLen 屬性的預設值是 0。設定 InputLen 為 0 時，使用 Input 將使 MSComm 控制元件讀取接收緩衝區中全部的內容。
若接收緩衝區中 InputLen 字元無效，Input 屬性返回一個零長度字串 ("")。在使用 Input 前，使用者可以選擇檢查 InBufferCount 屬性來確定緩衝區中是否已有需要數目的字元。該屬性在從輸出格式為定長資料的機器讀取資料時非常有用。
EOFEnable 屬性：確定在輸入過程中 MSComm 控制元件是否尋找檔案結尾 (EOF) 字元。如果找到 EOF 字元，將停止輸入並啟用 OnComm 事件，此時 CommEvent 屬性設定為 comEvEOF，
語法：object.EOFEnable [ = value ]
EOFEnable 屬性語法包括下列部分：
value 布林表示式，確定當找到 EOF 字元時，OnComm 事件是否被啟用，如“設定值”中所描述。 
value 的設定值：
True 當 EOF 字元找到時 OnComm 事件被啟用。 
False （預設）當 EOF 字元找到時 OnComm 事件不被啟用。 
說明：當 EOFEnable 屬性設定為 False，OnComm 控制元件將不在輸入流中尋找 EOF 字元。
錯誤訊息（MS Comm 控制元件）
下表列出 MSComm 控制元件可以捕獲的錯誤：
值 描述 
380 無效屬性值 comInvalidPropertyValue
383 屬性為只讀 comSetNotSupported
394 屬性為只讀 comGetNotSupported 
8000 埠開啟時操作不合法 comPortOpen
8001 超時值必須大於 0 
8002 無效埠號 comPortInvalid
8003 屬性只在執行時有效 
8004 屬性在執行時為只讀 
8005 埠已經開啟 comPortAlreadyOpen
8006 裝置識別符號無效或不支援該識別符號 
8007 不支援裝置的波特率 
8008 指定的位元組大小無效 
8009 預設引數錯誤 
8010 硬體不可用（被其它裝置鎖定） 
8011 函式不能分配佇列 
8012 裝置沒有開啟 comNoOpen 
8013 裝置已經開啟 
8014 不能使用 comm 通知 
8015 不能設定 comm 狀態 comSetCommStateFailed
8016 不能設定 comm 事件遮蔽 
8018 僅當埠開啟時操作才有效 comPortNotOpen 
8019 裝置忙 
8020 讀 comm 裝置錯誤 comReadError
8021 為該埠檢索裝置控制塊時的內部錯誤 comDCBError