_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 |
|
| DLL |
|