Função SetCommState (winbase.h)

Artigo
08/27/2023

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