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

Статья
03/03/2024

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

Синтаксис

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

См. также

Share via