MSComm控件在串口编程中使用
目次
MSComm控件两种处理通讯的方式
CommPort属性
RThreshold属性
CTSHolding属性
SThreshold属性
CDHolding属性
DSRHolding属性
Settings属性
InputLen属性
EOFEnable属性
Handshake常数
OnComm常数
InputMode常数
错误消息
MSComm 控件通过串行端口传输和接收数据，为应用程序提供串行通讯功能。MSComm控件在串口编程时非常方便，程序员不必去花时间去了解较为复杂的API函数，而且在VC、VB、Delphi等语言中均可使用。MicrosoftCommunicationsControl（以下简称MSComm）是Microsoft公司提供的简化Windows下串行通信编程的ActiveX控件，它为应用程序提供了通过串行接口收发数据的简便方法。具体的来说，它提供了两种处理通信问题的方法：一是事件驱动(Event－driven)方法，一是查询法。
1.MSComm控件两种处理通讯的方式
MSComm控件提供下列两种处理通讯的方式：事件驱动方式和查询方式。
1.1事件驱动方式
事件驱动通讯是处理串行端口交互作用的一种非常有效的方法。在许多情况下，在事件发生时需要得到通知，例如，在串口接收缓冲区中有字符，或者CarrierDetect(CD)或RequestToSend(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属性：确定是否可通过查询ClearToSend(CTS)线的状态发送数据。ClearToSend是调制解调器发送到相联计算机的信号，指示传输可以进行。该属性在设计时无效，在运行时为只读。
语法：object.CTSHolding（Boolean）
Mscomm控件的CTSHolding属性设置值：
TrueClearToSend线为高电平。
FalseClearToSend线为低电平。
说明：如果ClearToSend线为低电平(CTSHolding=False)并且超时时，MSComm控件设置CommEvent属性为comEventCTSTO(ClearToSendTimeout)并产生OnComm事件。
ClearToSend线用于RTS/CTS(RequestToSend/ClearToSend)硬件握手。如果需要确定ClearToSend线的状态，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常数
常数值描述
comNone0无握手。
comXonXoff1XOn/Xoff握手。
comRTS2Request-to-send/clear-to-send握手。
comRTSXOnXOff3Request-to-send和clear-to-send握手皆可。
OnComm常数
常数值描述
comEvSend1发送事件。
comEvReceive2接收事件。
comEvCTS3clear-to-send线变化。
comEvDSR4data-setready线变化。
comEvCD5carrierdetect线变化。
comEvRing6振铃检测。
comEvEOF7文件结束。
Error常数
常数值描述
comEventBreak1001接收到中断信号
comEventCTSTO1002Clear-to-send超时
comEventDSRTO1003Data-setready超时
comEventFrame1004帧错误
comEventOverrun1006端口超速
comEventCDTO1007Carrierdetect超时
comEventRxOver1008接收缓冲区溢出
comEventRxParity1009Parity错误
comEventTxFull1010传输缓冲区满
comEventDCB1011检索端口设备控制块(DCB)时的意外错误
InputMode常数
常数值描述
comInputModeText0（缺省）通过Input属性以文本方式取回数据。
comInputModeBinary1通过Input属性以二进制方式检取回数据。
CDHolding属性：通过查询CarrierDetect(CD)线的状态确定当前是否有传输。CarrierDetect是从调制解调器发送到相联计算机的一个信号，指示调制解调器正在联机。该属性在设计时无效，在运行时为只读。
语法object.CDHolding
设置值：CDHolding属性的设置值为：
设置描述
TrueCarrierDetect线为高电平
FalseCarrierDetect线为低电平
说明：注意当CarrierDetect线为高电平(CDHolding=True)且超时时，MSComm控件设置CommEvent属性为comEventCDTO（CarrierDetect超时错误），并产生OnComm事件。
注意在主机应用程序中捕获一个丢失的传输是特别重要的，例如一个公告板，因为呼叫者可以随时挂起（放弃传输）。
CarrierDetect也被称为ReceiveLineSignalDetect(RLSD)。
数据类型Boolean
DSRHolding属性：确定DataSetReady(DSR)线的状态。DataSetReady信号由调制解调器发送到相连计算机，指示作好操作准备。该属性在设计时无效，在运行时为只读。
语法：object.DSRHolding
object所在处表示对象表达式，其值是“应用于”列表中的对象。
DSRHolding属性返回以下值：
值描述
TrueDataSetReady线高
FalseDataSetReady线低
说明：当DataSetReady线为高电平(DSRHolding=True)且超时时，MSComm控件设置CommEvent属性为comEventDSRTO（数据准备超时）并产生OnComm事件。
当为DataTerminalEquipment(DTE)机器写DataSetReady/DataTerminalReady握手例程时该属性是十分有用的。
数据类型：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控件读取接收缓冲区中全部.<!-- google firefox --> <script type="text/javascript"> <!-- google_ad_client = "pub-8722551381340391"; google_ad_width = 468; google_ad_height = 60; google_ad_format = "468x60_as_rimg"; google_cpa_choice = "CAAQycb8zwEaCNrmdvgKt1bFKJnA93M"; //--> </script><script src="http://pagead2.googlesyndication.com/pagead/show_ads.js" type="text/javascript"></script>
MSComm控件两种处理通讯的方式
CommPort属性
RThreshold属性
CTSHolding属性
SThreshold属性
CDHolding属性
DSRHolding属性
Settings属性
InputLen属性
EOFEnable属性
Handshake常数
OnComm常数
InputMode常数
错误消息
MSComm 控件通过串行端口传输和接收数据，为应用程序提供串行通讯功能。MSComm控件在串口编程时非常方便，程序员不必去花时间去了解较为复杂的API函数，而且在VC、VB、Delphi等语言中均可使用。MicrosoftCommunicationsControl（以下简称MSComm）是Microsoft公司提供的简化Windows下串行通信编程的ActiveX控件，它为应用程序提供了通过串行接口收发数据的简便方法。具体的来说，它提供了两种处理通信问题的方法：一是事件驱动(Event－driven)方法，一是查询法。
1.MSComm控件两种处理通讯的方式
MSComm控件提供下列两种处理通讯的方式：事件驱动方式和查询方式。
1.1事件驱动方式
事件驱动通讯是处理串行端口交互作用的一种非常有效的方法。在许多情况下，在事件发生时需要得到通知，例如，在串口接收缓冲区中有字符，或者CarrierDetect(CD)或RequestToSend(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属性：确定是否可通过查询ClearToSend(CTS)线的状态发送数据。ClearToSend是调制解调器发送到相联计算机的信号，指示传输可以进行。该属性在设计时无效，在运行时为只读。
语法：object.CTSHolding（Boolean）
Mscomm控件的CTSHolding属性设置值：
TrueClearToSend线为高电平。
FalseClearToSend线为低电平。
说明：如果ClearToSend线为低电平(CTSHolding=False)并且超时时，MSComm控件设置CommEvent属性为comEventCTSTO(ClearToSendTimeout)并产生OnComm事件。
ClearToSend线用于RTS/CTS(RequestToSend/ClearToSend)硬件握手。如果需要确定ClearToSend线的状态，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常数
常数值描述
comNone0无握手。
comXonXoff1XOn/Xoff握手。
comRTS2Request-to-send/clear-to-send握手。
comRTSXOnXOff3Request-to-send和clear-to-send握手皆可。
OnComm常数
常数值描述
comEvSend1发送事件。
comEvReceive2接收事件。
comEvCTS3clear-to-send线变化。
comEvDSR4data-setready线变化。
comEvCD5carrierdetect线变化。
comEvRing6振铃检测。
comEvEOF7文件结束。
Error常数
常数值描述
comEventBreak1001接收到中断信号
comEventCTSTO1002Clear-to-send超时
comEventDSRTO1003Data-setready超时
comEventFrame1004帧错误
comEventOverrun1006端口超速
comEventCDTO1007Carrierdetect超时
comEventRxOver1008接收缓冲区溢出
comEventRxParity1009Parity错误
comEventTxFull1010传输缓冲区满
comEventDCB1011检索端口设备控制块(DCB)时的意外错误
InputMode常数
常数值描述
comInputModeText0（缺省）通过Input属性以文本方式取回数据。
comInputModeBinary1通过Input属性以二进制方式检取回数据。
CDHolding属性：通过查询CarrierDetect(CD)线的状态确定当前是否有传输。CarrierDetect是从调制解调器发送到相联计算机的一个信号，指示调制解调器正在联机。该属性在设计时无效，在运行时为只读。
语法object.CDHolding
设置值：CDHolding属性的设置值为：
设置描述
TrueCarrierDetect线为高电平
FalseCarrierDetect线为低电平
说明：注意当CarrierDetect线为高电平(CDHolding=True)且超时时，MSComm控件设置CommEvent属性为comEventCDTO（CarrierDetect超时错误），并产生OnComm事件。
注意在主机应用程序中捕获一个丢失的传输是特别重要的，例如一个公告板，因为呼叫者可以随时挂起（放弃传输）。
CarrierDetect也被称为ReceiveLineSignalDetect(RLSD)。
数据类型Boolean
DSRHolding属性：确定DataSetReady(DSR)线的状态。DataSetReady信号由调制解调器发送到相连计算机，指示作好操作准备。该属性在设计时无效，在运行时为只读。
语法：object.DSRHolding
object所在处表示对象表达式，其值是“应用于”列表中的对象。
DSRHolding属性返回以下值：
值描述
TrueDataSetReady线高
FalseDataSetReady线低
说明：当DataSetReady线为高电平(DSRHolding=True)且超时时，MSComm控件设置CommEvent属性为comEventDSRTO（数据准备超时）并产生OnComm事件。
当为DataTerminalEquipment(DTE)机器写DataSetReady/DataTerminalReady握手例程时该属性是十分有用的。
数据类型：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控件读取接收缓冲区中全部.<!-- google firefox --> <script type="text/javascript"> <!-- google_ad_client = "pub-8722551381340391"; google_ad_width = 468; google_ad_height = 60; google_ad_format = "468x60_as_rimg"; google_cpa_choice = "CAAQycb8zwEaCNrmdvgKt1bFKJnA93M"; //--> </script><script src="http://pagead2.googlesyndication.com/pagead/show_ads.js" type="text/javascript"></script>