Condividi tramite

classe Win32_SerialPortConfiguration

  • Articolo

La classe WMIWin32_SerialPortConfiguration rappresenta le impostazioni per la trasmissione dei dati in una porta seriale basata su Windows. Sono incluse le configurazioni per stabilire una connessione e un controllo degli errori.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate nell'ordine alfabetico, non nell'ordine MOF.

Sintassi

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

Members

La classe Win32_SerialPortConfiguration include questi tipi di membri:

Proprietà

La classe Win32_SerialPortConfiguration dispone di queste proprietà.

AbortReadWriteOnError

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fAbortOnError")

Se true, le operazioni di lettura e scrittura vengono terminate se si verifica un errore. Se TRUE, il driver termina tutte le operazioni di lettura e scrittura con stato di errore se si verifica un errore. Il driver non accetta ulteriori operazioni di comunicazione finché l'applicazione non riconosce l'errore.

Baudrate

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB| BaudRate")

Velocità baud (bit al secondo) in cui opera il dispositivo di comunicazione.

Esempio: 9600

BinaryModeEnabled

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fBinary")

Se TRUE, i trasferimenti di dati in modalità binaria sono abilitati per la porta seriale. I sistemi computer che eseguono Windows consentono solo i trasferimenti binari tramite porte seriali, quindi questo valore è sempre TRUE.

BitsPerByte

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB| ByteSize")

Numero di bit trasmessi e ricevuti per ogni byte di dati per la porta seriale di Windows. Il numero può variare con i bit di correzione degli errori e del controllo, ad esempio bit di parità.

Esempio: 8

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

Breve descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

ContinueXMitOnXOff

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fTXContinueOnXoff")

Se TRUE, le trasmissioni di dati continuano quando il buffer di input è compreso in byte XOffXMitThreshold di essere pieno e il driver ha trasmesso il valore XOffChararcter per arrestare la ricezione di byte. Se FALSE, la trasmissione non continua fino a quando il buffer di input non si trova all'interno di XOnXMitThreshold byte di essere vuoto e il driver ha trasmesso il valore XOnCharacter per riprendere la ricezione.

CTSOutflowControl

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fOutxCtsFlow")

Se TRUE, il segnale clear to send (CTS) viene controllato prima di trasmettere i dati. CTS segnala che entrambi i dispositivi nella connessione seriale sono pronti per trasferire i dati. La trasmissione dei dati viene sospesa fino a quando non viene fornito il segnale CTS.

Descrizione

Tipo di dati: stringa

Tipo di accesso: sola lettura

Descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

Elimina byteNULL

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fNull")

Se TRUE, i byte NULL (caratteri) vengono eliminati quando vengono ricevuti.

DSROutflowControl

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fOutxDsrFlow")

Se TRUE, il controllo del flusso di dati è abilitato quando è presente una condizione di data set ready (DSR). DSR segnala che la connessione è stata stabilita dai dispositivi nella connessione seriale. La trasmissione dati DSR viene sospesa fino a quando non viene fornito il segnale DSR.

DSRSensitivity

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fDsrSensitivity")

Se TRUE, il driver di comunicazione è sensibile allo stato del segnale DSR. Il driver ignora i byte ricevuti, a meno che la linea di input del modem DSR non sia elevata.

DTRFlowControlType

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fDtrControl")

Uso del controllo del flusso DTR (Data Terminal Ready) dopo che è stata stabilita una connessione.

Abilitare ("Abilita ")

Disabilita ("Disabilita ")

Handshake ("Handshake ")

EOFCharacter

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB| EofChar")

Valore del carattere utilizzato per segnalare la fine dei dati.

Esempio: ^Z

ErrorReplaceCharacter

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB| ErrorChar")

Valore del carattere utilizzato per sostituire i byte ricevuti con un errore di parità.

Esempio: ^C

ErrorReplacementEnabled

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fErrorChar")

Se TRUE, i byte ricevuti con errori di parità vengono sostituiti con il valore ErrorReplaceCharacter . I caratteri con errori di parità vengono sostituiti solo se questa proprietà è TRUE e la parità è abilitata.

EventCharacter

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | EvtChar")

Valore del carattere di controllo utilizzato per segnalare un evento, ad esempio la fine del file.

Esempio: ^e

Isbusy

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Funzioni file | CreateFile")

Se TRUE, la porta seriale è occupata.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

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

Nome della porta seriale di Windows.

Esempio: "COM1"

Parity

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | Parità")

Metodo di controllo della parità da utilizzare. La parità viene usata come tecnica di controllo degli errori in cui un bit di parità aggiuntivo è incluso in ogni unità di dati. Il ricevitore può quindi verificare la validità dei dati contando i bit impostati.

Nessuno ("Nessuno ")

Controllo parità non utilizzato.

Odd ("Odd")

Imposta il bit di parità in modo che il numero di bit sia dispari.

Anche ("even")

Imposta il bit di parità in modo che il numero di bit sia pari.

Mark ("Mark ")

Lascia il bit di parità impostato su 1.

Spazio ("Spazio ")

Lascia il bit di parità impostato su 0 (zero).

ParityCheckEnabled

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fParity")

Se TRUE, il controllo della parità è abilitato.

RTSFlowControlType

Tipo di dati: string

Tipo di accesso: sola lettura

Richiesta di invio (RTS) del controllo del flusso. RTS viene usato per segnalare che i dati sono disponibili per la trasmissione.

Abilita ("Abilita ")

RTS viene lasciato per la sessione di trasferimento dei dati.

Disabilitare ("Disabilita ")

RTS viene ignorato dopo la ricezione del primo segnale RTS.

Handshake ("Handshake ")

RTS è disattivato se il buffer di trasmissione è pieno più di tre quarti e RTS è attivato quando il buffer è inferiore a metà.

Attiva/ disattiva ("Attiva/Disattiva")

RTS è attivato se sono presenti dati memorizzati nel buffer per la trasmissione.

SettingID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (256)

Identificatore in base al quale è noto l'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

StopBits

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | StopBits")

Numero di bit di arresto da utilizzare. I bit di arresto separano ogni unità di dati in una connessione seriale asincrona. Vengono inoltre inviati continuamente quando non sono disponibili dati per la trasmissione.

1 ("1")

1.5 ("1.5")

2 ("2 ")

XOffCharacter

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | XoffChar")

Valore del carattere XOFF sia per la trasmissione che per la ricezione. XOFF è un controllo software per arrestare la trasmissione dei dati (mentre RTS e CTS sono controlli hardware). XON riprende la trasmissione.

XOffXMitThreshold

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | XoffLim")

Numero massimo di byte consentiti nel buffer di input prima dell'invio del carattere XOFF.

XOnCharacter

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | XonChar")

Valore del carattere XON sia per la trasmissione che per la ricezione. XON è un controllo software per riprendere la trasmissione dei dati (mentre RTS e CTS sono controlli hardware). XOFF arresta la trasmissione.

XOnXMitThreshold

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB | XonLim")

Numero minimo di byte consentiti nel buffer di input prima dell'invio del carattere XON. Questa proprietà funziona insieme a XOffXMitThreshold per regolare la frequenza in cui vengono trasferiti i dati.

XOnXOffInFlowControl

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fInX")

Se TRUE, il controllo del flusso XON/XOFF viene usato durante la ricezione. Se TRUE, il valore XOffCharacter viene inviato quando il buffer di input si trova all'interno di XOffXMitThreshold byte di essere completo e il valore XOnCharacter viene inviato quando il buffer di input rientra nei byte XOnXMitThreshold di essere vuoto.

0

FALSE

1

TRUE

XOnXOffOutFlowControl

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di comunicazione | DCB|fOutX")

XOnXOffOutFlowControl specifica se il controllo del flusso XON o XOFF viene usato durante la trasmissione. Se TRUE, la trasmissione si arresta quando viene ricevuto il valore XOffCharacter e viene avviato di nuovo quando viene ricevuto il valore XOnCharacter .

Commenti

La classe Win32_SerialPortConfiguration deriva da CIM_Setting.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Radice\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_Setting

Classi hardware del sistema computer