|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |