Функция SetCommMask определяет пакет событий, которые будут отслеживаться для коммуникационного устройства.
Синтаксис
BOOL SetCommMask( HANDLE hFile, DWORD dwEvtMask ); |
| Значение | Предназначение |
|---|---|
| EV_BREAK | При вводе данных было обнаружено прерывание. |
| EV_CTS | Сигнал готовности к приему (CTS) изменил состояние. |
| EV_DSR | Сигнал готовности модема (DSR) изменил состояние. |
| EV_ERR | Произошла ошибка состояния линии. Ошибкой состояния линии являются CE_FRAME, CE_OVERRUN и CE_RXPARITY. |
| EV_RING | Был обнаружен индикатор вызова. |
| EV_RLSD | Сигнал RLSD (детектор принимаемого линейного сигнала) изменил состояние. |
| EV_RXCHAR | Символ был принят и помещен в буфер ввода данных. |
| EV_RXFLAG | Символ события был принят и помещен в буфер ввода данных. Символ события определяется в структуре DCB устройства, которое обращается к последовательному порту, используя функцию SetCommState. |
| EV_TXEMPTY | Был отправлен последний символ из буфера вывода данных. |
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция SetCommMask определяет пакет событий, которые могут быть отслежены для конкретного коммуникационного ресурса. Дескриптор коммуникационного ресурса может быть определен при вызове функции WaitCommEvent, которая ожидает одно из происходящих событий. Чтобы получить текущую маску события коммуникационного ресурса, используйте функцию GetCommMask.
Код примера
Пример смотри в статье Отслеживание коммуникационных событий.
Смотри также
Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, CreateFile, DCB, GetCommMask, SetCommState, WaitCommEvent
|
Размещение и совместимость SetCommMask |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
|
т |
Windows 95 |
Да |
| С |
Windows 2003 Server |
Да |
| е |
Windows 2000 Server |
Да |
| р |
Windows NT Server |
Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
|
Заголовочный файл |
||
|
- объявлено в |
Winbase.h |
|
|
- включено в |
Windows.h |
|
|
Unicode |
- |
|
|
Замечания по платформе |
Не имеется |
|