Win32_SerialPortConfiguration 类

项目
06/12/2023

Win32_SerialPortConfigurationWMI 类表示基于 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|通信结构 |DCB|fAbortOnError“)

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

BaudRate

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |BaudRate“)

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

示例：9600

BinaryModeEnabled

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fBinary“)

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

BitsPerByte

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |ByteSize“)

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

示例：8

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

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

此属性继承自 CIM_Setting。

ContinueXMitOnXOff

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fTXContinueOnXoff“)

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

CTSOutflowControl

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fOutxCtsFlow“)

如果 为 TRUE，则会在传输数据之前检查发送 (CTS) 信号的清除。 CTS 指示串行连接上的两台设备已准备好传输数据。在提供 CTS 信号之前，将暂停数据传输。

描述

数据类型： string
访问类型：只读

当前对象的文本说明。

此属性继承自 CIM_Setting。

DiscardNULLBytes

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fNull“)

如果 为 TRUE，则接收) 字符 (NULL 字节将被丢弃。

DSROutflowControl

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fOutxDsrFlow“)

如果 为 TRUE，则当数据集就绪 (DSR) 条件时，将启用数据流出控制。 DSR 指示串行连接上的设备已建立连接。 DSR 数据传输暂停，直到发出 DSR 信号。

DSRSensitivity

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fDsrSensitivity“)

如果 为 TRUE，则通信驱动程序对 DSR 信号的状态敏感。除非 DSR 调制解调器输入线较高，否则驱动程序将忽略收到的任何字节。

DTRFlowControlType

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fDtrControl“)

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

启用 (“Enable”)

禁用 (“禁用”)

握手 (“握手”)

EOFCharacter

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |EofChar“)

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

示例：^Z

ErrorReplaceCharacter

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |ErrorChar“)

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

示例：^C

ErrorReplacementEnabled

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fErrorChar“)

如果 为 TRUE，则收到的具有奇偶校验错误的字节将替换为 ErrorReplaceCharacter 值。仅当此属性为 TRUE 且启用了奇偶校验时，才会替换出现奇偶校验错误的字符。

EventCharacter

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |EvtChar“)

用于向事件发出信号的控制字符的值，例如文件末尾。

示例：^e

IsBusy

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |CreateFile“)

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

名称

数据类型： 字符串
访问类型：只读
限定符：键、 MaxLen (256) 、 MappingStrings (“Win32Registry|Hardware\\DeviceMap\\SerialComm“)

Windows 串行端口的名称。

示例：“COM1”

Parity

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB |Parity“)

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

None (“None”)

未使用奇偶校验。

奇数 (“奇数”)

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

甚至 (“偶数”)

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

Mark (“Mark”)

将奇偶校验位保留为 1。

Space (“Space”)

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

ParityCheckEnabled

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fParity“)

如果 为 TRUE，则启用奇偶校验。

RTSFlowControlType

数据类型： 字符串
访问类型：只读

请求发送 (RTS) 流控制。 RTS 用于发出数据可用于传输的信号。

启用 (“Enable”)

为数据传输会话保留 RTS。

禁用 (“Disable”)

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

握手 (“握手”)

如果传输缓冲区已满超过四分之三，则 RTS 处于关闭状态;当缓冲区不足一半时，RTS 处于打开状态。

切换 (“切换”)

如果有任何数据缓冲用于传输，RTS 将打开。

SettingID

数据类型： 字符串
访问类型：只读
限定符： MaxLen (256)

已知当前对象的标识符。

此属性继承自 CIM_Setting。

停止位

数据类型： 字符串
访问类型：只读
限定符： 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 值。

FALSE

TRUE

XOnXOffOutFlowControl

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|通信结构 |DCB|fOutX“)

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

备注

Win32_SerialPortConfiguration 类派生自 CIM_Setting。

要求

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

另请参阅

CIM_Setting
计算机系统硬件类

通过

Win32_SerialPortConfiguration 类

语法

成员

属性

备注

要求

另请参阅

反馈

其他资源