_Classe SerialPortConfiguration Win32

la classe WMI Win32 _ SerialPortConfiguration représente les paramètres de transmission de données sur un port série basé sur Windows. Cela comprend les configurations permettant d’établir une connexion et une vérification des erreurs.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées par ordre alphabétique, et non par ordre MOF.

Syntaxe

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

Membres

La classe Win32 _ SerialPortConfiguration possède les types de membres suivants :

Propriétés

La classe Win32 _ SerialPortConfiguration a ces propriétés.

AbortReadWriteOnError

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fAbortOnError")

Si la valeur est true, les opérations de lecture et d’écriture sont terminées si une erreur se produit. Si la valeur est true, le pilote met fin à toutes les opérations de lecture et d’écriture avec un état d’erreur si une erreur se produit. Le pilote n’accepte aucune autre opération de communication tant que l’application n’a pas confirmé l’erreur.

BaudRate

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« | structures de communication win32api | DCB | baudrate »)

Vitesse en bauds (bits par seconde) à laquelle l’appareil de communication fonctionne.

Exemple : 9600

BinaryModeEnabled

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fBinary")

Si la valeur est true, les transferts de données en mode binaire sont activés pour le port série. les systèmes informatiques qui exécutent Windows autorisent uniquement les transferts binaires via les ports série. cette valeur est donc toujours TRUE.

BitsPerByte

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | , octets)

nombre de bits transmis et reçus pour chaque octet de données du port série Windows. Le nombre peut varier selon les bits de contrôle et de correction d’erreur, tels que les bits de parité.

Exemple : 8

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Courte description textuelle de l’objet actuel.

Cette propriété est héritée du _ paramètre CIM.

ContinueXMitOnXOff

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fTXContinueOnXoff")

Si la valeur est true, les transmissions de données continuent lorsque la mémoire tampon d’entrée se trouve dans XOffXMitThreshold octets de plein et que le pilote a transmis la valeur XOffChararcter pour arrêter la réception d’octets. Si la valeur est false, la transmission ne continue pas tant que la mémoire tampon d’entrée ne se trouve pas dans XOnXMitThreshold octets de vide et que le pilote a transmis la valeur XOnCharacter pour reprendre la réception.

CTSOutflowControl

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fOutxCtsFlow")

Si la valeur est true, le signal CTS (Clear to Send) est vérifié avant de transmettre les données. CTS signale que les deux appareils sur la connexion série sont prêts à transférer des données. La transmission de données est suspendue jusqu’à ce que le signal CTS soit donné.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description textuelle de l’objet actuel.

Cette propriété est héritée du _ paramètre CIM.

DiscardNULLBytes

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fNull")

Si la valeur est true, les octets nuls (caractères) sont ignorés lorsqu’ils sont reçus.

DSROutflowControl

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fOutxDsrFlow")

Si la valeur est true, le contrôle de flux de données est activé lorsqu’il existe une condition de jeu de données prêt (DSR). DSR signale que la connexion a été établie par les appareils sur la connexion série. La transmission des données DSR est suspendue jusqu’à ce que le signal DSR soit donné.

Sensibilité DSR

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fDsrSensitivity")

Si la valeur est true, le pilote de communication est sensible à l’état du signal DSR. Le pilote ignore les octets reçus, sauf si la ligne d’entrée du modem DSR est élevée.

DTRFlowControlType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fDtrControl")

Utilisation du contrôle de déroulement DTR (Data Terminal Ready) après l’établissement d’une connexion.

Activer (« activer »)

Désactiver (« désactiver »)

Protocole de transfert (« négociation »)

Caractère EOF

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | EofChar")

Valeur du caractère utilisé pour signaler la fin des données.

Exemple : ^ Z

ErrorReplaceCharacter

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | ErrorChar")

Valeur du caractère utilisé pour remplacer les octets reçus avec une erreur de parité.

Exemple : ^ C

ErrorReplacementEnabled

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fErrorChar")

Si la valeur est true, les octets reçus avec des erreurs de parité sont remplacés par la valeur ErrorReplaceCharacter . Les caractères avec des erreurs de parité sont remplacés uniquement si cette propriété a la valeur true et que la parité est activée.

EventCharacter

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | EvtChar")

Valeur du caractère de contrôle utilisé pour signaler un événement, telle que la fin du fichier.

Exemple : ^ e

IsBusy

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | fichier functions | CreateFile")

Si la valeur est true, le port série est occupé.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé, MaxLen (256), MappingStrings ("Win32Registry | Hardware \ \ DeviceMap \ \ SerialComm")

nom du port série Windows.

Exemple : « COM1 »

Parité

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« | structures de communication win32api | DCB | Parity »)

Méthode de contrôle de parité à utiliser. La parité est utilisée comme une technique de vérification des erreurs où un bit de parité supplémentaire est inclus avec chaque unité de données. Le récepteur peut ensuite vérifier la validité des données en comptant les bits qui sont définis.

Aucun (« aucun »)

Vérification de la parité non utilisée.

Impair (« impair »)

Définit le bit de parité afin que le nombre de bits défini soit un nombre impair.

Même (« pair »)

Définit le bit de parité afin que le nombre de bits défini soit un nombre pair.

Mark (« Mark »)

Laisse le bit de parité avec la valeur 1.

Espace (« Space »)

Laisse le bit de parité défini sur 0 (zéro).

ParityCheckEnabled

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fParity")

Si la valeur est true, le contrôle de parité est activé.

RTSFlowControlType

Type de données : chaîne

Type d'accès : Lecture seule

Contrôle de flow de demande d’envoi (RTS). RTS est utilisé pour signaler que les données sont disponibles pour la transmission.

Activer (« activer »)

RTS est conservé pour la session de transfert de données.

Désactiver (« désactiver »)

RTS est ignoré après la réception du premier signal RTS.

Protocole de transfert (« négociation »)

RTS est désactivé si la mémoire tampon de transmission est pleine de plus de trois quarts et que RTS est activé lorsque la mémoire tampon est inférieure à une moitié pleine.

Activer/désactiver (« bascule »)

RTS est activé si des données sont mises en mémoire tampon pour la transmission.

SettingID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Identificateur par lequel l’objet actuel est connu.

Cette propriété est héritée du _ paramètre CIM.

Bits d'arrêt

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | arrêt")

Nombre de bits d’arrêt à utiliser. Les bits d’arrêt séparent chaque unité de données sur une connexion série asynchrone. Ils sont également envoyés en continu quand aucune donnée n’est disponible pour la transmission.

1 (« 1 »)

1,5 ("1,5")

2 (« 2 »)

XOffCharacter

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | XoffChar")

Valeur du caractère XOFF pour la transmission et la réception. XOFF est un contrôle logiciel permettant d’arrêter la transmission de données (alors que RTS et CTS sont des contrôles matériels). XON reprend la transmission.

XOffXMitThreshold

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | XoffLim")

Nombre maximal d’octets autorisés dans la mémoire tampon d’entrée avant l’envoi du caractère XOFF.

XOnCharacter

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | XonChar")

Valeur du caractère XON pour la transmission et la réception. XON est un contrôle logiciel pour reprendre la transmission de données (alors que RTS et CTS sont des contrôles matériels). XOFF arrête la transmission.

XOnXMitThreshold

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | XonLim")

Nombre minimal d’octets autorisés dans la mémoire tampon d’entrée avant l’envoi du caractère XON. Cette propriété fonctionne conjointement avec XOffXMitThreshold pour réguler la vitesse à laquelle les données sont transférées.

XOnXOffInFlowControl

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fInX")

Si la valeur est true, le contrôle de workflow XON/XOFF est utilisé lors de la réception. Si la valeur est true, la valeur XOffCharacter est envoyée lorsque la mémoire tampon d’entrée se trouve dans XOffXMitThreshold octets de plein, et la valeur XOnCharacter est envoyée lorsque la mémoire tampon d’entrée est vide dans XOnXMitThreshold octets.

entre

FALSE

1

TRUE

XOnXOffOutFlowControl

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , structures de communication | DCB | fOutX")

Le XOnXOffOutFlowControl spécifie si le contrôle de Flow Xon ou XOFF est utilisé lors de la transmission. Si la valeur est true, la transmission s’arrête lorsque la valeur XOffCharacter est reçue et redémarre lorsque la valeur XOnCharacter est reçue.

Notes

La classe Win32 _ SerialPortConfiguration est dérivée du _ paramètre CIM.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_Paramètre CIM

Classes matérielles du système informatique