Partilhar via

classe Win32_SerialPortConfiguration

  • Artigo

A classe WMIWin32_SerialPortConfiguration representa as configurações de transmissão de dados em uma porta serial baseada no Windows. Isso inclui configurações para estabelecer uma conexão e verificação de erros.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_SerialPortConfiguration tem estes tipos de membros:

Propriedades

A classe Win32_SerialPortConfiguration tem essas propriedades.

AbortReadWriteOnError

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fAbortOnError")

Se TRUE, as operações de leitura e gravação serão encerradas se ocorrer um erro. Se TRUE, o driver encerrará todas as operações de leitura e gravação com um erro status se ocorrer um erro. O driver não aceitará mais nenhuma operação de comunicação até que o aplicativo reconheça o erro.

BaudRate

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| BaudRate")

Taxa de baud (bits por segundo) na qual o dispositivo de comunicações opera.

Exemplo: 9600

BinaryModeEnabled

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fBinary")

Se TRUE, as transferências de dados de modo binário serão habilitadas para a porta serial. Os sistemas de computador que executam o Windows permitem apenas transferências binárias por meio de portas seriais, portanto, esse valor é sempre TRUE.

BitsPerByte

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| ByteSize")

Número de bits transmitidos e recebidos para cada byte de dados para a porta serial do Windows. O número pode variar com bits de controle e correção de erro, como bits de paridade.

Exemplo: 8

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64)

Descrição textual curta do objeto atual.

Essa propriedade é herdada de CIM_Setting.

ContinueXMitOnXOff

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fTXContinueOnXoff")

Se TRUE, as transmissões de dados continuarão quando o buffer de entrada tiver entrado em bytes XOffXMitThreshold de estarem cheios e o driver transmitir o valor XOffChararcter para parar de receber bytes. Se FALSE, a transmissão não continuará até que o buffer de entrada esteja dentro de bytes XOnXMitThreshold de estarem vazios e o driver tenha transmitido o valor XOnCharacter para retomar a recepção.

CTSOutflowControl

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fOutxCtsFlow")

Se TRUE, o sinal de limpar para enviar (CTS) será verificado antes de transmitir dados. O CTS sinaliza que ambos os dispositivos na conexão serial estão prontos para transferir dados. A transmissão de dados é suspensa até que o sinal cts seja dado.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição textual do objeto atual.

Essa propriedade é herdada de CIM_Setting.

DiscardNULLBytes

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fNull")

Se TRUE, bytes NULL (caracteres) serão descartados quando forem recebidos.

DSROutflowControl

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fOutxDsrFlow")

Se TRUE, o controle de fluxo de saída de dados será habilitado quando houver uma condição de DSR (conjunto de dados pronto). A DSR sinaliza que a conexão foi estabelecida pelos dispositivos na conexão serial. A transmissão de dados DSR é suspensa até que o sinal DSR seja dado.

DSRSensitivity

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fDsrSensitivity")

Se TRUE, o driver de comunicações será sensível ao estado do sinal DSR. O driver ignora todos os bytes recebidos, a menos que a linha de entrada do modem DSR seja alta.

DTRFlowControlType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fDtrControl")

Uso do controle de fluxo pronto para o terminal de dados (DTR) depois que uma conexão for estabelecida.

Habilitar ("Habilitar")

Desabilitar ("Desabilitar")

Handshake ("Handshake")

EOFCharacter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| EofChar")

Valor do caractere usado para sinalizar o fim dos dados.

Exemplo: ^Z

ErrorReplaceCharacter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| ErrorChar")

Valor do caractere usado para substituir bytes recebidos por um erro de paridade.

Exemplo: ^C

ErrorReplacementEnabled

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fErrorChar")

Se TRUE, os bytes recebidos com erros de paridade serão substituídos pelo valor ErrorReplaceCharacter . Os caracteres com erros de paridade só serão substituídos se essa propriedade for TRUE e a paridade estiver habilitada.

EventCharacter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| EvtChar")

Valor do caractere de controle usado para sinalizar um evento, como o fim do arquivo.

Exemplo: ^e

Isbusy

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções de arquivo| CreateFile")

Se TRUE, a porta serial estará ocupada.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Nome da porta serial do Windows.

Exemplo: "COM1"

Paridade

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| Paridade")

Método de verificação de paridade a ser usado. A paridade é usada como uma técnica de verificação de erros em que um bit de paridade extra é incluído em cada unidade de dados. Em seguida, o receptor pode verificar a validade dos dados contando os bits que estão definidos.

Nenhum ("Nenhum")

Verificação de paridade não usada.

Ímpar ("Ímpar")

Define o bit de paridade de modo que a contagem de bits definida seja um número ímpar.

Mesmo ("Even")

Define o bit de paridade de modo que a contagem de bits definida seja um número par.

Marcar ("Marcar")

Deixa o bit de paridade definido como 1.

Espaço ("Espaço")

Deixa o bit de paridade definido como 0 (zero).

ParityCheckEnabled

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fParity")

Se TRUE, a verificação de paridade estará habilitada.

RTSFlowControlType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Solicitação para enviar o controle de fluxo (RTS). O RTS é usado para sinalizar que os dados estão disponíveis para transmissão.

Habilitar ("Habilitar")

O RTS é deixado ligado para a sessão de transferência de dados.

Desabilitar ("Desabilitar")

O RTS é ignorado depois que o primeiro sinal RTS é recebido.

Handshake ("Handshake")

O RTS será desativado se o buffer de transmissão estiver mais de três quartos cheio e o RTS estiver ativado quando o buffer estiver com menos de metade do total.

Alternar ("Alternar")

O RTS será ativado se houver dados armazenados em buffer para transmissão.

Settingid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (256)

Identificador pelo qual o objeto atual é conhecido.

Essa propriedade é herdada de CIM_Setting.

Stopbits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| StopBits")

Número de bits de parada a serem usados. Os bits de parada separam cada unidade de dados em uma conexão serial assíncrona. Eles também são enviados continuamente quando nenhum dado está disponível para transmissão.

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| XoffChar")

Valor do caractere XOFF para transmissão e recepção. O XOFF é um controle de software para interromper a transmissão de dados (enquanto RTS e CTS são controles de hardware). O XON retoma a transmissão.

XOffXMitThreshold

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| XoffLim")

Número máximo de bytes permitidos no buffer de entrada antes do caractere XOFF ser enviado.

XOnCharacter

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| XonChar")

Valor do caractere XON para transmissão e recepção. O XON é um controle de software para retomar a transmissão de dados (enquanto RTS e CTS são controles de hardware). O XOFF interrompe a transmissão.

XOnXMitThreshold

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB| XonLim")

Número mínimo de bytes permitidos no buffer de entrada antes do caractere XON ser enviado. Essa propriedade funciona em conjunto com XOffXMitThreshold para regular a taxa na qual os dados são transferidos.

XOnXOffInFlowControl

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fInX")

Se TRUE, o controle de fluxo XON/XOFF será usado durante a recepção. Se TRUE, o valor XOffCharacter é enviado quando o buffer de entrada vem dentro de bytes XOffXMitThreshold de estar cheio e o valor XOnCharacter é enviado quando o buffer de entrada entra em bytes XOnXMitThreshold de estar vazio.

0

FALSE

1

TRUE

XOnXOffOutFlowControl

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de comunicação| DCB|fOutX")

O XOnXOffOutFlowControl especifica se o controle de fluxo XON ou XOFF é usado durante a transmissão. Se TRUE, a transmissão será interrompida quando o valor XOffCharacter for recebido e será iniciada novamente quando o valor XOnCharacter for recebido.

Comentários

A classe Win32_SerialPortConfiguration é derivada de CIM_Setting.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_Setting

Classes de hardware do sistema de computador