Função SetCommState (winbase.h)
Configura um dispositivo de comunicações de acordo com as especificações em um bloco de controle de dispositivo (uma estrutura DCB ). A função reinicializa todas as configurações de hardware e controle, mas não esvazia filas de entrada ou saída.
Sintaxe
BOOL SetCommState(
[in] HANDLE hFile,
[in] LPDCB lpDCB
);
Parâmetros
[in] hFile
Um identificador para o dispositivo de comunicações. A função CreateFile retorna esse identificador.
[in] lpDCB
Um ponteiro para uma estrutura dcb que contém as informações de configuração para o dispositivo de comunicações especificado.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função SetCommState usa uma estrutura DCB para especificar a configuração desejada. A função GetCommState retorna a configuração atual.
Para definir apenas alguns membros da estrutura dcb , você deve modificar uma estrutura dcb que foi preenchida por uma chamada para GetCommState. Isso garante que os outros membros da estrutura dcb tenham valores apropriados.
A função SetCommState falhará se o membro XonChar da estrutura DCB for igual ao membro XoffChar .
Quando SetCommState é usado para configurar o 8250, as seguintes restrições se aplicam aos valores dos membros ByteSize e StopBits da estrutura DCB:
O número de bits de dados deve ser de 5 a 8 bits.
Exemplos
Para obter um exemplo, consulte Configurando um recurso de comunicação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |