Поделиться через


Функция GetCommModemStatus (winbase.h)

Извлекает значения регистра управления модемом.

Синтаксис

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

Параметры

[in] hFile

Дескриптор устройства связи. Функция CreateFile возвращает этот дескриптор.

[out] lpModemStat

Указатель на переменную, которая получает текущее состояние значений регистра управления модемом. Этот параметр может иметь одно или несколько из следующих значений.

Значение Значение
MS_CTS_ON
0x0010
Сигнал CTS (очистить для отправки) включен.
MS_DSR_ON
0x0020
Сигнал DSR (data-set-ready) включен.
MS_RING_ON
0x0040
Сигнал кольцевого индикатора включен.
MS_RLSD_ON
0x0080
Сигнал RLSD (receive-line-signal-detect) включен.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция GetCommModemStatus полезна при использовании функции WaitCommEvent для мониторинга сигналов CTS, RLSD, DSR или сигналов кольцевого индикатора. Чтобы определить, когда эти сигналы изменяют состояние, используйте WaitCommEvent , а затем используйте GetCommModemStatus , чтобы определить состояние после изменения.

Функция завершается сбоем, если оборудование не поддерживает значения регистра управления.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Функции связи

Ресурсы связи

CreateFile

WaitCommEvent