GetCommModemStatus

9/8/2008

Essa função recupera controle modem-registrar valores.

Syntax

BOOL GetCommModemStatus(
  HANDLE hFile,
  LPDWORD lpModemStat
);

Parameters

• hFile
  [no] Identificador para o dispositivo de comunicação, retornado pela função a CreateFile.

• lpModemStat
  [out] Ponteiro longo para um 32-variável bit que especifica o atual estado do controle de modem-registrar valores. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  MS_CTS_ON	O sinal (CTS) criptografado para-enviar é No.
  MS_DSR_ON	O sinal de dados-conjunto-pronto (DSR) está no.
  MS_RING_ON	O sinal indicador de anel é No.
  MS_RLSD_ON	A recepção-linha - sinal - detecção (RLSD) sinal é No.

Return Value

Nonzero indica sucesso. Zero indica falha. Para obter estendido dados de erro, chamar a função GetLastError.

Remarks

O GetCommModemStatus função é útil quando usando a função WaitCommEvent para monitor de CTS, DSR, DSR ou sinais indicador de anel.

A detecção quando esses sinais alteração estado, use WaitCommEvent e em seguida, use GetCommModemStatus Para determinar o estado após uma alteração ocorre.

A função falhará se o hardware não suporte o controle-registrar valores.

Requirements

Header	winbase.h
Library	Serdev.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Serial Communications Functions
WaitCommEvent

Other Resources

CreateFile