Win32_SerialPortConfiguration classe
La classe WMI Win32_SerialPortConfiguration représente les paramètres de transmission de données sur un port série Windows. Cela inclut les configurations pour l’établissement d’une connexion et la 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 dans l’ordre alphabétique, et non dans l’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 comporte 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 se terminent en cas d’erreur. Si la valeur est TRUE, le pilote met fin à toutes les opérations de lecture et d’écriture avec une erreur status si une erreur se produit. Le pilote n’accepte pas d’autres opérations de communication tant que l’application n’a pas reconnu l’erreur.
-
-
BaudRate
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de communication| DCB| BaudRate »)
Vitesse de 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 exécutant Windows autorisent uniquement les transferts binaires via les ports série, de sorte que cette valeur est toujours TRUE.
-
-
BitsPerByte
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de communication| DCB| ByteSize « )
Nombre de bits transmis et reçus pour chaque octet de données pour le 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)
Brève description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
-
-
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 est entrée dans les octets XOffXMitThreshold d’être saturé et que le pilote a transmis la valeur XOffChararcter pour arrêter de recevoir des octets. Si la valeur est FALSE, la transmission ne se poursuit pas tant que la mémoire tampon d’entrée n’est pas en octets XOnXMitThreshold 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 clear to send (CTS) est vérifié avant de transmettre les données. CTS signale que les deux appareils de la connexion série sont prêts à transférer des données. La transmission des 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 de CIM_Setting.
-
-
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 NULL (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 sortie de données est activé lorsqu’il existe une condition prête pour le jeu de données (DSR). DSR signale que la connexion a été établie par les appareils sur la connexion série. La transmission de données DSR est suspendue jusqu’à ce que le signal DSR soit donné.
-
-
DSRSensitivité
-
-
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 tous 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 flux prêt pour le terminal de données (DTR) après l’établissement d’une connexion.
-
-
Activer (« Activer »)
-
Désactiver (« Désactiver »)
-
Négociation (« Poignée de main »)
EOFCharacter
-
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 par 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 présentant des erreurs de parité ne sont remplacés que si cette propriété a la valeur TRUE et si 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, tel que la fin du fichier.
Exemple : ^e
Isbusy
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Fonctions de fichier| 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 : key, 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 (« Win32API| Structures de communication| DCB| Parité « )
Méthode de vérification de la parité à utiliser. La parité est utilisée comme 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 définis.
None (« None »)
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.
Even (« Even »)
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 (« Espace »)
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, la vérification de la parité est activée.
RTSFlowControlType
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Contrôle de flux de requête d’envoi (RTS). RTS est utilisé pour signaler que les données sont disponibles pour la transmission.
Activer (« Activer »)
RTS reste activé pour la session de transfert de données.
Désactiver (« Désactiver »)
RTS est ignoré après la réception du premier signal RTS.
Négociation (« Poignée de main »)
RTS est désactivé si la mémoire tampon de transmission est saturée de plus de trois quarts, et RTS est activé lorsque la mémoire tampon est saturée de moins de la moitié.
Bascule (« Bascule »)
RTS est activé s’il existe des données 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 de CIM_Setting.
Bits d'arrêt
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de communication| DCB| StopBits »)
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. Elles sont également envoyées en continu lorsqu’aucune donnée n’est disponible pour 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 (tandis 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 permettant de reprendre la transmission de données (tandis 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 le taux de transfert des donné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 flux 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 les octets XOffXMitThreshold d’être complet, et la valeur XOnCharacter est envoyée lorsque la mémoire tampon d’entrée se trouve dans les octets XOnXMitThreshold d’être vide.
0
FAUX
true
XOnXOffOutFlowControl
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de communication | DCB|fOutX »)
Le contrôle de flux XOnXOffOutFlowControl spécifie si le contrôle de flux XON ou XOFF est utilisé pendant 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 de CIM_Setting.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Racine\CIMV2 |
MOF |
|
DLL |
|
Voir aussi