Compartilhar via


Função EscapeCommFunction (winbase.h)

Direciona o dispositivo de comunicações especificado para executar uma função estendida.

Sintaxe

BOOL EscapeCommFunction(
  [in] HANDLE hFile,
  [in] DWORD  dwFunc
);

Parâmetros

[in] hFile

Um identificador para o dispositivo de comunicações. A função CreateFile retorna esse identificador.

[in] dwFunc

A função estendida a ser executada. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
CLRBREAK
9
Restaura a transmissão de caracteres e coloca a linha de transmissão em um estado de não quebra. O código de função estendida CLRBREAK é idêntico à função ClearCommBreak .
CLRDTR
6
Limpa o sinal DTR (pronto para o terminal de dados).
CLRRTS
4
Limpa o sinal RTS (solicitação para enviar).
SETBREAK
8
Suspende a transmissão de caracteres e coloca a linha de transmissão em um estado de interrupção até que a função ClearCommBreak seja chamada (ou EscapeCommFunction seja chamado com o código de função estendida CLRBREAK). O código da função estendida SETBREAK é idêntico à função SetCommBreak . Observe que essa função estendida não libera dados que não foram transmitidos.
SETDTR
5
Envia o sinal DTR (pronto para o terminal de dados).
SETRTS
3
Envia o sinal RTS (solicitação para enviar).
SETXOFF
1
Faz com que a transmissão atue como se um caractere XOFF tivesse sido recebido.
SETXON
2
Faz com que a transmissão atue como se um caractere XON tivesse sido recebido.

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.

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 (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

ClearCommBreak

Funções de comunicação

Recursos de comunicação

CreateFile

SetCommBreak