Win32 _ SerialPortConfiguration 类

Win32 _ SerialPortConfiguration WMI 类表示在基于 Windows 的串行端口上进行数据传输的设置。 这包括用于建立连接和错误检查的配置。

以下语法从托管对象格式 (MOF) 代码中简化,包括所有继承的属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。

语法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4EB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SerialPortConfiguration : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  boolean AbortReadWriteOnError;
  uint32  BaudRate;
  boolean BinaryModeEnabled;
  uint32  BitsPerByte;
  boolean ContinueXMitOnXOff;
  boolean CTSOutflowControl;
  boolean DiscardNULLBytes;
  boolean DSROutflowControl;
  boolean DSRSensitivity;
  string  DTRFlowControlType;
  uint32  EOFCharacter;
  uint32  ErrorReplaceCharacter;
  boolean ErrorReplacementEnabled;
  uint32  EventCharacter;
  boolean IsBusy;
  string  Name;
  string  Parity;
  boolean ParityCheckEnabled;
  string  RTSFlowControlType;
  string  StopBits;
  uint32  XOffCharacter;
  uint32  XOffXMitThreshold;
  uint32  XOnCharacter;
  uint32  XOnXMitThreshold;
  uint32  XOnXOffInFlowControl;
  uint32  XOnXOffOutFlowControl;
};

成员

Win32 _ SerialPortConfiguration 类具有以下类型的成员:

属性

Win32 _ SerialPortConfiguration 类具有以下属性。

AbortReadWriteOnError

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fAbortOnError" )

如果 为 TRUE,则当发生错误时,读取和写入操作将终止。 如果 为 TRUE,则当发生错误时,驱动程序将终止所有读取和写入操作并显示错误状态。 在应用程序确认错误之前,驱动程序不会接受任何进一步的通信操作。

波特率

数据类型: uint32

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | 波特率" )

波特率 (每秒位数) 通信设备的运行速率。

示例:9600

BinaryModeEnabled

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fBinary" )

如果 为 TRUE,则为串行端口启用二进制模式数据传输。 运行 Windows 的计算机系统只允许通过串行端口进行二进制传输,因此,此值始终 为 TRUE

BitsPerByte

数据类型: uint32

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | ByteSize" )

为 Windows 串行端口的每个字节的数据传输和接收的位数。 该数字可能因控制和错误更正位(如奇偶校验位)而异。

示例:8

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64)

当前对象的简短文本说明。

此属性继承自 CIM _ 设置

ContinueXMitOnXOff

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fTXContinueOnXoff" )

如果 为 TRUE,则当输入缓冲区在 XOffXMitThreshold 字节内已满并且驱动程序已将 XOffChararcter 值传输到停止接收字节时,数据传输将继续。 如果 为 FALSE,则在输入缓冲区处于空的 XOnXMitThreshold 字节内并且驱动程序已传输 XOnCharacter 值以恢复接收时,传输不会继续。

CTSOutflowControl

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fOutxCtsFlow" )

如果 为 TRUE,则在传输数据之前会检查要发送 (CTS) 信号。 CTS 发出信号,指示串行连接上的两个设备都可以传输数据。 数据传输将暂停,直到提供 CTS 信号。

说明

数据类型: 字符串

访问类型:只读

当前对象的文本说明。

此属性继承自 CIM _ 设置

DiscardNULLBytes

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fNull" )

如果 为 TRUE,则 在收到 NULL 字节 (字符时将丢弃这些字符) 。

DSROutflowControl

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fOutxDsrFlow" )

如果为 TRUE,则当数据集准备好 (DSR) 条件时,会启用数据流控制。 DSR 发出信号表示连接已由串行连接上的设备建立。 在提供 DSR 信号之前,将暂停 DSR 数据传输。

DSRSensitivity

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fDsrSensitivity" )

如果 为 TRUE,则通信驱动程序对 DSR 信号的状态是敏感的。 该驱动程序将忽略接收到的所有字节,除非 DSR 调制解调器输入线路很高。

DTRFlowControlType

数据类型: 字符串

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | fDtrControl" )

建立连接后,使用数据终端就绪 (DTR) 流控制。

启用 ( "enable" )

禁用 ( "disable" )

握手 ( "握手" )

EOFCharacter

数据类型: uint32

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | EofChar" )

用于指示数据结束的字符的值。

示例: ^ Z

ErrorReplaceCharacter

数据类型: uint32

访问类型:只读

限定符: MappingStrings ( "Win32API | Communication 结构 | DCB | ErrorChar" )

用于将收到的字节替换为奇偶校验错误的字符的值。

示例:^C

ErrorReplacementEnabled

数据类型: 布尔值

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | fErrorChar")

如果 为 TRUE, 则收到的具有奇偶校验错误的字节将替换为 ErrorReplaceCharacter 值。 只有在此属性为 TRUE 且启用了奇偶校验时,才替换具有奇偶校验错误的字符。

EventCharacter

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | EvtChar")

用于向事件发出信号的控件字符的值,例如文件结尾。

示例:^e

IsBusy

数据类型: 布尔值

访问类型:只读

限定符 :MappingStrings ("Win32API | 文件函数 | CreateFile")

如果 为 TRUE, 则串行端口正忙。

名称

数据类型 :string

访问类型:只读

限定符: 、MaxLen (256 ) 、MappingStrings ("Win32Registry Hardware | \ \ DeviceMap \ \ SerialComm")

串行端口Windows的名称。

示例:"COM1"

Parity

数据类型 :string

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | 奇偶校验")

要使用的奇偶校验检查方法。 奇偶校验用作错误检查技术,其中每个数据单元都包含额外的奇偶校验位。 然后,接收方可以通过计算设置的位来验证数据的有效性。

("None")

未使用奇偶校验检查。

("奇")

设置奇偶校验位,使位数等于奇数。

甚至 ("Even")

设置奇偶校验位,使位数等于偶数。

("Mark")

将奇偶校验位保留为 1。

Space ("Space")

将奇偶校验位设置为 0 (零) 。

ParityCheckEnabled

数据类型: 布尔值

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | fParity")

如果 为 TRUE, 则启用奇偶校验检查。

RTSFlowControlType

数据类型 :string

访问类型:只读

请求发送 (RTS) 流控制。 RTS 用于指示数据可用于传输。

启用 ("启用")

对于数据传输会话,RTS 将一直打开。

禁用 ("禁用")

收到第一个 RTS 信号后,将忽略 RTS。

握手 (" 握手")

如果传输缓冲区已满四分之三以上,RTS 将关闭,当缓冲区已满一半时,RTS 将打开。

切换 ("切换")

如果有用于传输的缓冲数据,RTS 将打开。

SettingID

数据类型 :string

访问类型:只读

限定符 :MaxLen (256)

当前对象的已知标识符。

此属性继承自 CIM _ 设置

停止位

数据类型 :string

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | StopBits")

要使用的停止位数。 停止位分隔异步串行连接上每个数据单元。 当没有数据可用于传输时,也会持续发送这些数据。

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | XoffChar")

用于传输和接收的 XOFF 字符的值。 XOFF 是一种软件控件,用于停止 (,而 RTS 和 CTS 是硬件) 。 XON 恢复传输。

XOffXMitThreshold

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | XoffLim")

发送 XOFF 字符之前输入缓冲区中允许的最大字节数。

XOnCharacter

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | XonChar")

用于传输和接收的 XON 字符的值。 XON 是一种软件控件,用于恢复数据传输 (而 RTS 和 CTS 是硬件) 。 XOFF 停止传输。

XOnXMitThreshold

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | XonLim")

发送 XON 字符之前输入缓冲区中允许的最小字节数。 此属性与 XOffXMitThreshold 结合使用,以控制数据传输速率。

XOnXOffInFlowControl

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API 通信结构 | | DCB | fInX")

如果 为 TRUE, 则接收期间使用 XON/XOFF 流控制。 如果 为 TRUE, 则当输入缓冲区位于已满的 XOffXMitThreshold 字节内时发送 XOffCharacter 值,当输入缓冲区位于为空的 XOnXMitThreshold 字节内时,将发送 XOnCharacter 值。

0

false

1

true

XOnXOffOutFlowControl

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API | 通信结构 | DCB | fOutX")

XOnXOffOutFlowControl 指定在传输期间是使用 XON 还是 XOFF 流控制。 如果 为 TRUE, 则传输在 接收 XOffCharacter 值时停止,并接收 XOnCharacter 值时再次启动。

备注

Win32 _ SerialPortConfiguration 类派生自 CIM _ 设置

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
根 \ CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM _ 设置

计算机系统硬件类