Win32_SerialPortConfiguration-Klasse

  • Artikel

Die Win32_SerialPortConfigurationWMI-Klasse stellt die Einstellungen für die Datenübertragung an einem Windows-basierten seriellen Port dar. Dies schließt Konfigurationen zum Herstellen einer Verbindung und Fehlerüberprüfung ein.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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;
};

Member

Die Win32_SerialPortConfiguration-Klasse verfügt über folgende Membertypen:

Eigenschaften

Die Win32_SerialPortConfiguration-Klasse verfügt über diese Eigenschaften.

AbortReadWriteOnError

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fAbortOnError")

Bei TRUE werden Lese- und Schreibvorgänge beendet, wenn ein Fehler auftritt. Bei TRUE beendet der Treiber alle Lese- und Schreibvorgänge mit einem Fehler status, wenn ein Fehler auftritt. Der Treiber akzeptiert keine weiteren Kommunikationsvorgänge, bis die Anwendung den Fehler bestätigt.

BaudRate

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| BaudRate")

Baudrate (Bits pro Sekunde), mit der das Kommunikationsgerät arbeitet.

Beispiel: 9600

BinaryModeEnabled

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fBinary")

Bei TRUE sind Datenübertragungen im binärmodus für den seriellen Port aktiviert. Computersysteme, auf denen Windows ausgeführt wird, lassen binäre Übertragungen nur über serielle Ports zu, sodass dieser Wert immer TRUE ist.

BitsPerByte

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| ByteSize")

Anzahl der Bits, die für jedes Datenbyte für den seriellen Windows-Port übertragen und empfangen werden. Die Anzahl kann je nach Steuerungs- und Fehlerkorrekturbits variieren, z. B. Paritätsbits.

Beispiel: 8

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

ContinueXMitOnXOff

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fTXContinueOnXoff")

Bei TRUE werden die Datenübertragungen fortgesetzt, wenn der Eingabepuffer innerhalb von XOffXMitThreshold-Bytes voll ist und der Treiber den XOffChararcter-Wert übertragen hat, um den Empfang von Bytes zu beenden. Bei FALSE wird die Übertragung erst fortgesetzt, wenn der Eingabepuffer innerhalb von XOnXMitThreshold Bytes leer ist und der Treiber den XOnCharacter-Wert übertragen hat, um den Empfang fortzusetzen.

CTSOutflowControl

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fOutxCtsFlow")

Bei TRUE wird das CTS-Signal (Clear to Send) vor der Übertragung von Daten überprüft. CTS signalisiert, dass beide Geräte auf der seriellen Verbindung bereit sind, Daten zu übertragen. Die Datenübertragung wird angehalten, bis das CTS-Signal gegeben ist.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

DiscardNULLBytes

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fNull")

Bei TRUE werden NULL-Bytes (Zeichen) verworfen, wenn sie empfangen werden.

DSROutflowControl

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fOutxDsrFlow")

Bei TRUE ist die Datenabflusssteuerung aktiviert, wenn eine DsR-Bedingung (Data Set Ready) vorliegt. DsR signalisiert, dass die Verbindung von den Geräten in der seriellen Verbindung hergestellt wurde. Die DsR-Datenübertragung wird angehalten, bis das DsR-Signal gegeben wird.

DSRSensitivity

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fDsrSensitivity")

True gibt an, dass der Kommunikationstreiber den Status des DSR-Signals berücksichtigt. Der Treiber ignoriert alle empfangenen Bytes, es sei denn, die DSR-Modemeingabeleitung ist hoch.

DTRFlowControlType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fDtrControl")

Verwendung der DTR-Flusssteuerung (Data Terminal Ready), nachdem eine Verbindung hergestellt wurde.

Aktivieren ("Aktivieren")

Deaktivieren ("Deaktivieren")

Handshake ("Handshake")

EOFCharacter

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| EofChar")

Wert des Zeichens, das zum Signalisieren des Datenendes verwendet wird.

Beispiel: ^Z

ErrorReplaceCharacter

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| ErrorChar")

Wert des Zeichens, das verwendet wird, um empfangene Bytes durch einen Paritätsfehler zu ersetzen.

Beispiel: ^C

ErrorReplacementEnabled

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fErrorChar")

Bei TRUE werden empfangene Bytes mit Paritätsfehlern durch den ErrorReplaceCharacter-Wert ersetzt. Zeichen mit Paritätsfehlern werden nur ersetzt, wenn diese Eigenschaft TRUE ist und die Parität aktiviert ist.

EventCharacter

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| EvtChar")

Wert des Steuerelementzeichens, das zum Signalisieren eines Ereignisses verwendet wird, z. B. Dateiende.

Beispiel: ^e

Isbusy

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dateifunktionen| CreateFile")

Bei TRUE ist der serielle Port ausgelastet.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: key, MaxLen (256), MappingStrings ("Win32Registry| Hardware\\DeviceMap\\SerialComm")

Name des seriellen Windows-Ports.

Beispiel: "COM1"

Parität

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| Parität")

Methode der zu verwendenden Paritätsprüfung. Die Parität wird als Fehlerüberprüfungsmethode verwendet, bei der in jeder Dateneinheit ein zusätzliches Paritätsbit enthalten ist. Der Empfänger kann dann die Gültigkeit der Daten überprüfen, indem er die festgelegten Bits zählt.

Keine ("Keine")

Die Paritätsprüfung wird nicht verwendet.

Ungerade ("ungerade")

Legt das Paritätsbit fest, sodass die Anzahl der festgelegten Bits eine ungerade Zahl ist.

Gerade ("gerade")

Legt das Paritätsbit fest, sodass die Anzahl der festgelegten Bits eine gerade Zahl ist.

Mark ("Mark")

Behält die Festlegung des Paritätsbits auf 1 bei.

Leerzeichen ("Space")

Lässt das Paritätsbit auf 0 (null) festgelegt.

ParityCheckEnabled

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fParity")

Wenn TRUE, ist die Paritätsprüfung aktiviert.

RTSFlowControlType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Anforderung zum Senden (RTS)-Flusssteuerung. RTS wird verwendet, um zu signalisieren, dass Daten für die Übertragung verfügbar sind.

Aktivieren ("Aktivieren")

RTS bleibt für die Datenübertragungssitzung aktiviert.

Deaktivieren ("Deaktivieren")

RTS wird ignoriert, nachdem das erste RTS-Signal empfangen wurde.

Handshake ("Handshake")

RTS wird deaktiviert, wenn der Übertragungspuffer mehr als drei Viertel voll ist, und RTS wird aktiviert, wenn der Puffer weniger als die Hälfte voll ist.

Umschalten ("Umschalten")

RTS ist aktiviert, wenn Daten für die Übertragung gepuffert sind.

SettingID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (256)

Bezeichner, unter dem das aktuelle Objekt bekannt ist.

Diese Eigenschaft wird von CIM_Setting geerbt.

Stoppbits

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| StopBits")

Anzahl der zu verwendenden Stoppbits. Stoppbits trennen jede Dateneinheit auf einer asynchronen seriellen Verbindung. Sie werden auch kontinuierlich gesendet, wenn keine Daten zur Übertragung verfügbar sind.

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| XoffChar")

Wert des XOFF-Zeichens für Übertragung und Empfang. XOFF ist ein Softwaresteuerelement, um die Übertragung von Daten zu stoppen (während RTS und CTS Hardwaresteuerungen sind). XON setzt die Übertragung fort.

XOffXMitThreshold

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| XoffLim")

Maximale Anzahl von Bytes, die im Eingabepuffer zulässig sind, bevor das XOFF-Zeichen gesendet wird.

XOnCharacter

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| XonChar")

Wert des XON-Zeichens für Übertragung und Empfang. XON ist eine Softwaresteuerung zum Fortsetzen der Übertragung von Daten (während RTS und CTS Hardwaresteuerungen sind). XOFF stoppt die Übertragung.

XOnXMitThreshold

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB| XonLim")

Minimale Anzahl von Bytes, die im Eingabepuffer zulässig sind, bevor das XON-Zeichen gesendet wird. Diese Eigenschaft arbeitet in Verbindung mit XOffXMitThreshold , um die Rate zu steuern, mit der Daten übertragen werden.

XOnXOffInFlowControl

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fInX")

Wenn TRUE, wird die XON/XOFF-Flusssteuerung während des Empfangs verwendet. Bei TRUE wird der XOffCharacter-Wert gesendet, wenn der Eingabepuffer innerhalb der XOffXMitThreshold-Byte von voll ist, und der XOnCharacter-Wert wird gesendet, wenn der Eingabepuffer in XOnXMitThreshold-Bytes leer ist.

0

FALSE

1

TRUE

XOnXOffOutFlowControl

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Kommunikationsstrukturen| DCB|fOutX")

Die XOnXOffOutFlowControl gibt an, ob die XON- oder XOFF-Flusssteuerung während der Übertragung verwendet wird. Bei TRUE wird die Übertragung beendet, wenn der XOffCharacter-Wert empfangen wird, und startet erneut, wenn der XOnCharacter-Wert empfangen wird.

Bemerkungen

Die Win32_SerialPortConfiguration-Klasse wird von CIM_Setting abgeleitet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM_Setting

Hardwareklassen des Computersystems