Функция 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

-

 

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz