Modificação das configurações de recurso de comunicações

Quando a função CreateFile abre um identificador para um recurso de comunicação serial, o sistema inicializa e configura o recurso de acordo com os valores configurados na última vez em que o recurso foi aberto. Preservar as configurações anteriores permite que o usuário mantenha as configurações especificadas por meio de um comando de modo quando o dispositivo for reaberto. Os valores herdados da operação aberta anterior incluem as configurações do bloco de controle do dispositivo (uma estrutura dedcb) e os valores de tempo limite usados em operações de E/S. Se o dispositivo nunca tiver sido aberto, ele será configurado com os padrões do sistema.

Para determinar a configuração inicial de um recurso de comunicação serial, um processo chama a função GetCommState, que preenche uma porta serial estrutura de DCB com as configurações atuais. Para modificar essa configuração, um processo especifica uma estrutura de DCB em uma chamada para a funçãoSetCommState.

Os membros da estrutura deDCB especificam as configurações, como a taxa de baud, o número de bits de dados por byte e o número de bits de parada por byte. Outros membros DCB especificar caracteres especiais e habilitar a verificação de paridade e o controle de fluxo. Quando um processo precisa modificar apenas algumas dessas configurações, ele deve primeiro chamar GetCommState para preencher uma estrutura DCB com a configuração atual. Em seguida, o processo pode ajustar os valores importantes na estrutura de do DCB e reconfigurar o dispositivo chamando SetCommState e especificando a estrutura de dcb modificada. Este procedimento garante que os membros não modificados da estrutura de DCB contenham valores apropriados. Por exemplo, um erro comum é configurar um dispositivo com uma estrutura de DCB na qual o membro XonChar da estrutura é igual ao membro do XoffChar.

A funçãoBuildCommDCB fornece outra maneira de modificar uma estrutura dedo DCB. BuildCommDCB usa uma cadeia de caracteres com o mesmo formulário que os argumentos de linha de comando do modo comando para especificar a taxa de baud, o esquema de paridade, o número de bits de parada e o número de bits de dados. Os membros restantes do DCB não são alterados por essa função, exceto que os membros apropriados estão definidos para desabilitar o XON/XOFF e o controle de fluxo de hardware. BuildCommDCB modifica apenas uma estrutura de do DCB; ele não reconfigura o dispositivo.

Um processo pode reconfigurar um recurso de comunicação usando a função GetCommProperties para obter informações de um driver de dispositivo sobre as configurações que ele dá suporte. O processo pode usar essas informações para evitar a especificação de uma configuração sem suporte.

A função SetCommState reconfigura o recurso de comunicação, mas não afeta a saída interna e os buffers de entrada do driver especificado. Os buffers não são liberados e as operações de leitura e gravação pendentes não são encerradas prematuramente.

Um processo reinicializa um recurso de comunicação usando a função SetupComm, que executa as seguintes tarefas:

• Encerra as operações pendentes de leitura e gravação, mesmo que elas não tenham sido concluídas.
• Descarta caracteres não lidos e libera os buffers internos de saída e entrada do driver associado ao recurso especificado.
• Realoca a saída interna e os buffers de entrada.

Um processo não é necessário para chamar SetupComm. Caso contrário, o driver do recurso inicializa o dispositivo com as configurações padrão na primeira vez em que o identificador de recurso de comunicações é usado.