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
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_Setting

Classes matérielles du système informatique