DCB

9/8/2008

Essa estrutura define a configuração controle para um serial dispositivo de comunicação.

Syntax

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;

Os membros

• DCBlength
  Especifica o DCB estrutura comprimento, em bytes.

• BAUDRATE
  Especifica o taxa de transmissão no qual o dispositivo de comunicação opera. É um real valor taxa de transmissão, ou uma do seguinte índices taxa de transmissão:

  • CBR_110
  • CBR_300
  • CBR_600
  • CBR_1200
  • CBR_2400
  • CBR_4800
  • CBR_9600
  • CBR_14400
  • CBR_19200
  • CBR_38400
  • CBR_56000
  • CBR_57600
  • CBR_115200
  • CBR_128000
  • CBR_256000

• fBinary
  Especifica se binário modo está habilitado. A função não transferências nonbinary modo suporte, para esse membro deve ser definido como TRUE.

• fParity
  Especifica se a verificação paridade está habilitado. Se esse membro é definido como TRUE, paridade verificação é executada e erros são relatados.

• fOutxCtsFlow
  Especifica se o sinal (CTS) criptografado para-enviar é monitorado para saída fluxo controle. Se esse membro é definido como TRUE e CTS está desativada, saída será suspensa até que CTS é enviada novamente.

• fOutxDsrFlow
  Especifica se o sinal de dados-conjunto-pronto (DSR) é monitorado para saída fluxo controle. Se esse membro é definido como TRUE e DSR está desativada, saída for suspenso até que DSR seja enviado novamente.

• fDtrControl
  Especifica que os dados - terminal - pronto controle fluxo (DTR). A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  DTR_CONTROL_DISABLE	Desativa a linha DTR quando o dispositivo é aberto e deixa-la desativado.
  DTR_CONTROL_ENABLE	Permite que a linha DTR quando o dispositivo é aberto e deixa-lo.
  DTR_CONTROL_HANDSHAKE	Permite handshaking DTR. Se o handshake é habilitado, ele é um erro de aplicativo para ajustar a linha usando a função EscapeCommFunction.

• fDsrSensitivity
  Especifica se o driver de comunicação confidencial para o estado do sinal Data-Send-Ready (DSR). Se esse membro for definido como TRUE, o driver ignorará os bytes recebidos, a menos que a entrada modem de DSR linha é alta.

• fTXContinueOnXoff
  Especifica se a transmissão pára quando o buffer de entrada está cheio e o driver foi transmitida a XoffChar caractere. Se esse membro for definido como TRUE, a transmissão continuará após o buffer de entrada chegou dentro XoffLim Bytes de sendo completo e o driver foi transmitida a XoffChar caractere para parar o recebimento bytes.

  Se esse membro é definido como FALSE, transmissão não continuará até que esteja dentro de buffer de entrada XonLim Bytes de sendo vazio e o driver foi transmitida a XonChar caractere para recepção continuar.

• fOutX
  Especifica se controle de fluxo XON/XOFF é usado durante a transmissão. Se esse membro for definido como TRUE, transmissão pára quando o XoffChar caractere é recebida e inicia novamente quando o XonChar caractere é recebido.

• fInX
  Especifica se controle de fluxo XON/XOFF é usado durante a recepção. Se esse membro for definido como TRUE, o XoffChar caractere é enviado quando o buffer de entrada vem dentro XoffLim Bytes de sendo completo e o XonChar caractere é enviado quando o buffer de entrada vem dentro XonLim Bytes de sendo vazio.

• fErrorChar
  Especifica se os bytes recebidos com erros paridade são substituídos pelo caractere especificado pelo ErrorChar membro. Se esse membro for definido como TRUE e o fParity membro é definido como TRUE, ocorre a substituição.

• fNull
  Especifica se NULL bytes são descartados. Se esse membro for definido como TRUE, NULL bytes serão descartadas quando recebidos.

• fRtsControl
  Especifica o controle de fluxo Request-To-Send (RTS). Se esse valor for definido para zero, o usar como padrão é RTS_CONTROL_HANDSHAKE. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  RTS_CONTROL_DISABLE	Desativa a linha RTS quando o dispositivo é aberto e deixa-la desativado.
  RTS_CONTROL_ENABLE	Habilita a linha RTS quando o dispositivo é aberto e deixa-lo.
  RTS_CONTROL_HANDSHAKE	Permite handshaking RTS. Os driver raises os RTS linha quando a reserva Type-Ahead (entrada) é menor do que metade completo e lowers os RTS linha quando a reserva é mais de três quartos completo. Se Handshake estiver habilitado, ele é um erro de aplicativo para ajustar a linha usando o EscapeCommFunction função.
  RTS_CONTROL_TOGGLE	Especifica que a linha RTS é alta se bytes disponível para transmissão. Afinal de contas armazenada em buffer bytes são enviados, a linha RTS é baixa.

• fAbortOnError
  Especifica se ler e operações de gravação serão encerradas se ocorrer um erro. Se esse membro for definido como TRUE, o driver finaliza todas as operações de gravação com um status de erro e ler se ocorrer um erro. O driver não aceitar outras comunicações operações até que o aplicativo confirma o erro por chamado a função ClearCommError.

• fDummy2
  Reservado; Não use.

• wReserved
  Não usado; definido como zero.

• XonLim
  Especifica o número mínimo de bytes aceitos no buffer de entrada para o caractere Xon é enviada.

• XoffLim
  Especifica o número máximo de bytes aceitos no buffer de entrada para o caractere XOff é enviada. O número máximo de bytes aceitos é calculado pela subtraindo esse valor a partir de tamanho, em bytes, da buffer de entrada.

• ByteSize
  Especifica o número de bits em de bytes transmitidos e recebidos.

• Paridade
  Especifica a esquema paridade a ser usado. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  EVENPARITY	Mesmo
  MARKPARITY	Marcar
  NOPARITY	Sem paridade
  ODDPARITY	Ímpar
  SPACEPARITY	Espaço

• StopBits
  Especifica o número de bits parar a ser usado. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  ONESTOPBIT	bit 1 parar
  ONE5STOPBITS	1,5 bits parar
  TWOSTOPBITS	2 stop bits

• XonChar
  Especifica o valor do caractere XON para transmissão e recepção.

• XoffChar
  Especifica o valor do caractere XOFF para transmissão e recepção.

• ErrorChar
  Especifica o valor do caractere usado para substituir bytes recebidos com erro de paridade.

• EofChar
  Especifica o valor do caractere usado para sinalizar o final dos dados.

• EvtChar
  Especifica o valor do caractere usado para sinalizar um evento.

• wReserved1
  Reservado; Não use.

Remarks

O driver PDD porta serial exemplo é o Diretório %_WINCEROOT%\Public\Common\Oak\Drivers\Serial.

Todas as pastas sob a pasta serial contêm serial exemplo drivers PDD, exceto para as pastas COM_MDD e COM_MDD2.

Requirements

Header	winbase.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Serial Communications Structures
ClearCommError
EscapeCommFunction
GetCommState
SetCommState