Функция GetCommModemStatus

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

Синтаксис

BOOL GetCommModemStatus(
  HANDLE hFile,
  LPDWORD lpModemStat
);

Параметры

hFile

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

lpModemStat

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

Значение	Предназначение
MS_CTS_ON	Включается сигнал готовности к приему (CTS).
MS_DSR_ON	Включается сигнал готовности модема (DSR).
MS_RING_ON	Включается сигнал индикатора вызова.
MS_RLSD_ON	Включается сигнал RLSD (детектор принимаемого линейного сигнала).

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

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

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

Замечания

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

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

Смотри также

Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, COMMCONFIG, CreateFile, GetDefaultCommConfig, SetCommConfig

Размещение и совместимость GetCommModemStatus
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Да версии 4.0
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Да

С	Windows 2003 Server	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Да версии 4.0
в
е
р
	Используемая библиотека	Kernel32.lib
	Заголовочный файл
	- объявлено в	Winbase.h
	- включено в	Windows.h
	Unicode	-
	Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

В оглавление справки