На главную

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 | Скачать Вниз

PurgeComm



The PurgeComm function can discard all characters from the output or input buffer of a specified communications resource. It can also terminate pending read or write operations on the resource.

BOOL PurgeComm(

HANDLE hFile, // handle of communications resource
DWORD dwFlags // action to perform
);


Parameters

hFile

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

dwFlags

Specifies the action to take. This parameter can be a combination of the following values:

Value Meaning
PURGE_TXABORT Terminates all outstanding write operations and returns immediately, even if the write operations have not been completed.
PURGE_RXABORT Terminates all outstanding read operations and returns immediately, even if the read operations have not been completed.
PURGE_TXCLEAR Clears the output buffer (if the device driver has one).
PURGE_RXCLEAR Clears the input buffer (if the device driver has one).


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

If a thread uses PurgeComm to flush an output buffer, the deleted characters are not transmitted. To empty the output buffer while ensuring that the contents are transmitted, call the FlushFileBuffers function (a synchronous operation). Note, however, that FlushFileBuffers is subject to flow control but not to write time-outs, and it will not return until all pending write operations have been transmitted.

See Also

CreateFile


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

PurgeComm



Функция PurgeComm может отвергнуть все символы с выхода или вводить буфер определенного ресурса связи. Это может также завершить рассматривать прочитанное или действия записи в ресурсе.

BOOL PurgeComm(

РУЧКА hFile, // ручка ресурса связи DWORD dwFlags // действие, чтобы выполняться
);


Параметры

hFile

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

dwFlags

Определяет действие, чтобы требоваться. Этот параметр может быть комбинацией следующего величин:

Значение Величины
PURGE_TXABORT Завершает все выдающиеся писать действия и возвращает немедленно, даже если бы писать действия не завершены.
PURGE_RXABORT Завершает все выдающиеся действия чтения и возвращает немедленно, даже если бы действия чтения не завершены.
PURGE_TXCLEAR Очищает выходной буфер (если водитель устройства имеет один).
PURGE_RXCLEAR Очищает входной буфер (если водитель устройства имеет один).


Обратные Величины

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

Замечания

Если резьба использует PurgeComm, чтобы сбрасывать выходной буфер, удаленные символы не переданы. На пустой выходной буфер при обеспечении, что содержание передано, названо функция FlushFileBuffers ( синхронная операция). Примечание, тем не менее, что FlushFileBuffers подвергается управлению потока но не, чтобы записывать задержки, и это не возвращается пока все незаконченные операции записи не переданы.

Смотри Также

CreateFile


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