Функция GetCommMask

Функция GetCommMask извлекает данные о значении маски события для указанного коммуникационного устройства.

Синтаксис

BOOL GetCommMask(
  HANDLE hFile,
  LPDWORD lpEvtMask
);

Параметры

hFile

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

lpEvtMask

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

 

Значение Предназначение
EV_BREAK Во время ввода данных было обнаружено прерывание.
EV_CTS Сигнал готовности к приему (CTS) изменил состояние.
EV_DSR Сигнал готовности модема (DSR) изменил состояние.
EV_ERR Произошла ошибка состояния линии. Ошибкой состояния линии являются CE_FRAME, CE_OVERRUN и CE_RXPARITY.
EV_EVENT1 Произошло событие первого, определяемого поставщиком, типа.
EV_EVENT2 Произошло событие второго, определяемого поставщиком, типа.
EV_PERR Произошла ошибка принтера.
EV_RING Был обнаружен кольцевой индикатор.
EV_RLSD Сигнал RLSD (детектор принимаемого линейного сигнала) изменил состояние.
EV_RX80FULL Принимающийся буфер заполнен на 80 процентов.
EV_RXCHAR Символ был принят и помещен в буфер ввода данных.
EV_RXFLAG Символ события был принят и помещен в буфер ввода данных. Символ события определяется  в структуре DCB устройства, которое обращается к последовательному порту, используя функцию SetCommState.
EV_TXEMPTY Был отправлен последний символ из буфера вывода данных.

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

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

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

Замечания

Функция GetCommMask использует переменную маски, чтобы указывать множество событий, которые могут быть отслежены для конкретного коммуникационного ресурса. Дескриптор коммуникационного ресурса может быть определен при вызове функции WaitCommEvent, которая ожидает одно из происходящих событий. Чтобы изменить маску события коммуникационного ресурса, используйте функцию SetCommMask.

Смотри также

Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, CreateFile, DCB, SetCommMask, WaitCommEvent

Размещение и совместимость GetCommMask

К

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

-

 

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

Не имеется

 

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

Hosted by uCoz