На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetCommMask



The SetCommMask function specifies a set of events to be monitored for a communications device.

BOOL SetCommMask(

HANDLE hFile, // handle of communications device
DWORD dwEvtMask // mask that identifies enabled events
);


Parameters

hFile

Identifies the communications device. The CreateFile function returns this handle.

dwEvtMask

Specifies the events to be enabled. A value of zero disables all events. This parameter can be a combination of the following values:

Value Meaning
EV_BREAK A break was detected on input.
EV_CTS The CTS (clear-to-send) signal changed state.
EV_DSR The DSR (data-set-ready) signal changed state.
EV_ERR A line-status error occurred. Line-status errors are CE_FRAME, CE_OVERRUN, and CE_RXPARITY.
EV_RING A ring indicator was detected.
EV_RLSD The RLSD (receive-line-signal-detect) signal changed state.
EV_RXCHAR A character was received and placed in the input buffer.
EV_RXFLAG The event character was received and placed in the input buffer. The event character is specified in the device's DCB structure, which is applied to a serial port by using the SetCommState function.
EV_TXEMPTY The last character in the output buffer was sent.


Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The SetCommMask function specifies the set of events that can be monitored for a particular communications resource. A handle to the communications resource can be specified in a call to the WaitCommEvent function, which waits for one of the events to occur. To get the current event mask of a communications resource, use the GetCommMask function.
If SetCommMask is called for a communications resource while an overlapped wait is pending for that resource, WaitCommEvent returns an error.

See Also

CreateFile, DCB, GetCommMask, SetCommState, WaitCommEvent


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetCommMask



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

BOOL SetCommMask(

РУЧКА hFile, // ручка устройства связи DWORD dwEvtMask // маскируют, что идентифицируют разблокированные события
);


Параметры

hFile

Идентифицирует устройство связи. Функция CreateFile возвращает эту ручку.

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.
Если SetCommMask назван к ресурсу связи пока перекрытое ожидание рассматривается для этого ресурса, WaitCommEvent возвращает ошибку.

Смотри Также

CreateFile, DCB, GetCommMask, SetCommState, WaitCommEvent


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz