Estrutura dcb (winbase.h)

Artigo
08/27/2023

Define a configuração de controle para um dispositivo de comunicação serial.

Sintaxe

typedef struct _DCB {
  DWORD DCBlength;
  DWORD BaudRate;
  DWORD fBinary : 1;
  DWORD fParity : 1;
  DWORD fOutxCtsFlow : 1;
  DWORD fOutxDsrFlow : 1;
  DWORD fDtrControl : 2;
  DWORD fDsrSensitivity : 1;
  DWORD fTXContinueOnXoff : 1;
  DWORD fOutX : 1;
  DWORD fInX : 1;
  DWORD fErrorChar : 1;
  DWORD fNull : 1;
  DWORD fRtsControl : 2;
  DWORD fAbortOnError : 1;
  DWORD fDummy2 : 17;
  WORD  wReserved;
  WORD  XonLim;
  WORD  XoffLim;
  BYTE  ByteSize;
  BYTE  Parity;
  BYTE  StopBits;
  char  XonChar;
  char  XoffChar;
  char  ErrorChar;
  char  EofChar;
  char  EvtChar;
  WORD  wReserved1;
} DCB, *LPDCB;

Membros

DCBlength

O comprimento da estrutura, em bytes. O chamador deve definir esse membro como sizeof(DCB).

BaudRate

A taxa de bugigangas na qual o dispositivo de comunicações opera. Esse membro pode ser um valor de taxa de baud real ou um dos índices a seguir.

Valor	Significado
CBR_110 110	110 bps
CBR_300 300	300 bps
CBR_600 600	600 bps
CBR_1200 1200	1200 bps
CBR_2400 2400	2400 bps
CBR_4800 4800	4800 bps
CBR_9600 9600	9600 bps
CBR_14400 14400	14400 bps
CBR_19200 19200	19200 bps
CBR_38400 38400	38400 bps
CBR_57600 57600	57600 bps
CBR_115200 115200	115200 bps
CBR_128000 128000	128000 bps
CBR_256000 256000	256000 bps

fBinary

Se esse membro for TRUE, o modo binário estará habilitado. O Windows não dá suporte a transferências de modo não binário, portanto, esse membro deve ser TRUE.

fParity

Se esse membro for TRUE, a verificação de paridade será executada e os erros serão relatados.

fOutxCtsFlow

Se esse membro for TRUE, o sinal CTS (desmarcado para enviar) será monitorado para o controle de fluxo de saída. Se esse membro for TRUE e o CTS estiver desativado, a saída será suspensa até que o CTS seja enviado novamente.

fOutxDsrFlow

Se esse membro for TRUE, o sinal DSR (pronto para conjunto de dados) será monitorado para o controle de fluxo de saída. Se esse membro for TRUE e a DSR estiver desativada, a saída será suspensa até que a DSR seja enviada novamente.

fDtrControl

O controle de fluxo DTR (pronto para terminal de dados). Esse membro pode ser um dos valores a seguir.

Valor	Significado
DTR_CONTROL_DISABLE 0x00	Desabilita a linha DTR quando o dispositivo é aberto e o deixa desabilitado.
DTR_CONTROL_ENABLE 0x01	Habilita a linha DTR quando o dispositivo é aberto e o deixa ligado.
DTR_CONTROL_HANDSHAKE 0x02	Habilita o handshaking de DTR. Se o handshaking estiver habilitado, será um erro para o aplicativo ajustar a linha usando a função EscapeCommFunction .

fDsrSensitivity

Se esse membro for 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.

fTXContinueOnXoff

Se esse membro for TRUE, a transmissão continuará depois que o buffer de entrada tiver entrado em bytes XoffLim de estar cheio e o driver tiver transmitido o caractere XoffChar para parar de receber bytes. Se esse membro for FALSE, a transmissão não continuará até que o buffer de entrada esteja dentro de bytes XonLim de estar vazio e o driver tenha transmitido o caractere XonChar para retomar a recepção.

fOutX

Indica se o controle de fluxo XON/XOFF é usado durante a transmissão. Se esse membro for TRUE, a transmissão será interrompida quando o caractere XoffChar for recebido e será iniciada novamente quando o caractere XonChar for recebido.

fInX

Indica se o controle de fluxo XON/XOFF é usado durante a recepção. Se esse membro for TRUE, o caractere XoffChar será enviado quando o buffer de entrada chegar dentro de bytes XoffLim de estar cheio e o caractere XonChar for enviado quando o buffer de entrada chegar dentro de bytes XonLim de estar vazio.

fErrorChar

Indica se os bytes recebidos com erros de paridade são substituídos pelo caractere especificado pelo membro ErrorChar . Se esse membro for TRUE e o membro fParity for TRUE, ocorrerá a substituição.

fNull

Se esse membro for TRUE, bytes nulos serão descartados quando recebidos.

fRtsControl

O controle de fluxo RTS (solicitação para enviar). Esse membro pode ser um dos valores a seguir.

Valor	Significado
RTS_CONTROL_DISABLE 0x00	Desabilita a linha RTS quando o dispositivo é aberto e o deixa desabilitado.
RTS_CONTROL_ENABLE 0x01	Habilita a linha RTS quando o dispositivo é aberto e o deixa ligado.
RTS_CONTROL_HANDSHAKE 0x02	Habilita o handshaking rts. O driver aciona a linha RTS quando o buffer "type-ahead" (entrada) está menos de metade cheio e reduz a linha RTS quando o buffer está mais de três quartos cheio. Se o handshaking estiver habilitado, será um erro para o aplicativo ajustar a linha usando a função EscapeCommFunction .
RTS_CONTROL_TOGGLE 0x03	Especifica que a linha RTS será alta se os bytes estiverem disponíveis para transmissão. Depois que todos os bytes armazenados em buffer forem enviados, a linha RTS será baixa.

fAbortOnError

Se esse membro for 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 confirme o erro chamando a função ClearCommError .

fDummy2

Reservado; não use.

wReserved

Reservados; deve ser zero.

XonLim

O número mínimo de bytes em uso permitido no buffer de entrada antes que o controle de fluxo seja ativado para permitir a transmissão pelo remetente. Isso pressupõe que o controle de fluxo de entrada XON/XOFF, RTS ou DTR seja especificado nos membros fInX, fRtsControl ou fDtrControl .

XoffLim

O número mínimo de bytes livres permitidos no buffer de entrada antes que o controle de fluxo seja ativado para inibir o remetente. Observe que o remetente pode transmitir caracteres depois que o sinal de controle de fluxo tiver sido ativado, portanto, esse valor nunca deve ser zero. Isso pressupõe que o controle de fluxo de entrada XON/XOFF, RTS ou DTR seja especificado nos membros fInX, fRtsControl ou fDtrControl . O número máximo de bytes em uso permitidos é calculado subtraindo esse valor do tamanho, em bytes, do buffer de entrada.

ByteSize

O número de bits nos bytes transmitidos e recebidos.

Parity

O esquema de paridade a ser usado. Esse membro pode ser um dos valores a seguir.

Valor	Significado
EVENPARITY 2	Paridade mesmo.
MARKPARITY 3	Marcar paridade.
NOPARITY 0	Sem paridade.
ODDPARITY 1	Paridade estranha.
SPACEPARITY 4	Paridade de espaço.

StopBits

O número de bits de parada a serem usados. Esse membro pode ser um dos valores a seguir.

Valor	Significado
ONESTOPBIT 0	1 bit de parada.
ONE5STOPBITS 1	1,5 bits de parada.
TWOSTOPBITS 2	2 bits de parada.

XonChar

O valor do caractere XON para transmissão e recepção.

XoffChar

O valor do caractere XOFF para transmissão e recepção.

ErrorChar

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

EofChar

O valor do caractere usado para sinalizar o fim dos dados.

EvtChar

O valor do caractere usado para sinalizar um evento.

wReserved1

Reservado; não use.

Comentários

Quando uma estrutura DCB é usada para configurar o 8250, as seguintes restrições se aplicam aos valores especificados para os membros ByteSize e StopBits :

O número de bits de dados deve ser de 5 a 8 bits.
O uso de 5 bits de dados com 2 bits de parada é uma combinação inválida, assim como 6, 7 ou 8 bits de dados com 1,5 bits de parada.