Функция 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 |
- |
|
Замечания по платформе |
Не имеется |