Compartilhar via

Função GetCommModemStatus (winbase.h)

  • Artigo

Recupera os valores de registro de controle de modem.

Sintaxe

BOOL GetCommModemStatus(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpModemStat
);

Parâmetros

[in] hFile

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

[out] lpModemStat

Um ponteiro para uma variável que recebe o estado atual dos valores de registro de controle de modem. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
MS_CTS_ON
0x0010
 O sinal CTS (limpar para enviar) está ativado.
MS_DSR_ON
0x0020
 O sinal DSR (pronto para conjunto de dados) está ativado.
MS_RING_ON
0x0040
 O sinal do indicador de anel está ativado.
MS_RLSD_ON
0x0080
 O sinal RLSD (receive-line-signal-detect) está ativado.

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 GetCommModemStatus é útil quando você está usando a função WaitCommEvent para monitorar os sinais de indicador CTS, RLSD, DSR ou anel. Para detectar quando esses sinais mudam de estado, use WaitCommEvent e, em seguida, use GetCommModemStatus para determinar o estado após a alteração.

A função falhará se o hardware não der suporte aos valores de registro de controle.

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

Funções de comunicação

Recursos de comunicação

CreateFile

WaitCommEvent