Función GetCommModemStatus (winbase.h)

  • Artículo

Recupera los valores de registro de control de módem.

Sintaxis

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

Parámetros

[in] hFile

Identificador del dispositivo de comunicaciones. La función CreateFile devuelve este identificador.

[out] lpModemStat

Puntero a una variable que recibe el estado actual de los valores de registro de control del módem. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
MS_CTS_ON
0x0010
 La señal CTS (clear-to-send) está activada.
MS_DSR_ON
0x0020
 La señal DSR (lista para el conjunto de datos) está activada.
MS_RING_ON
0x0040
 La señal del indicador de anillo está activada.
MS_RLSD_ON
0x0080
 La señal RLSD (receive-line-signal-detect) está activada.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetCommModemStatus es útil cuando se usa la función WaitCommEvent para supervisar las señales ctS, RLSD, DSR o indicador de anillo. Para detectar cuándo cambian estas señales, use WaitCommEvent y, a continuación, use GetCommModemStatus para determinar el estado después de que se produzca un cambio.

Se produce un error en la función si el hardware no admite los valores de registro de control.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de comunicaciones

Recursos de comunicaciones

CreateFile

WaitCommEvent