На главную

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

COMMTIMEOUTS



The COMMTIMEOUTS structure is used in the SetCommTimeouts and GetCommTimeouts functions to set and query the time-out parameters for a communications device. The parameters determine the behavior of ReadFile, WriteFile, ReadFileEx, and WriteFileEx operations on the device.

typedef struct _COMMTIMEOUTS { // ctmo
DWORD ReadIntervalTimeout;
DWORD ReadTotalTimeoutMultiplier;
DWORD ReadTotalTimeoutConstant;
DWORD WriteTotalTimeoutMultiplier;
DWORD WriteTotalTimeoutConstant;
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;


Members

ReadIntervalTimeout

Specifies the maximum time, in milliseconds, allowed to elapse between the arrival of two characters on the communications line. During a ReadFile operation, the time period begins when the first character is received. If the interval between the arrival of any two characters exceeds this amount, the ReadFile operation is completed and any buffered data is returned. A value of zero indicates that interval time-outs are not used.
A value of MAXDWORD, combined with zero values for both the ReadTotalTimeoutConstant and ReadTotalTimeoutMultiplier members, specifies that the read operation is to return immediately with the characters that have already been received, even if no characters have been received.

ReadTotalTimeoutMultiplier

Specifies the multiplier, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is multiplied by the requested number of bytes to be read.

ReadTotalTimeoutConstant

Specifies the constant, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is added to the product of the ReadTotalTimeoutMultiplier member and the requested number of bytes.
A value of zero for both the ReadTotalTimeoutMultiplier and ReadTotalTimeoutConstant members indicates that total time-outs are not used for read operations.

WriteTotalTimeoutMultiplier

Specifies the multiplier, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is multiplied by the number of bytes to be written.

WriteTotalTimeoutConstant

Specifies the constant, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is added to the product of the WriteTotalTimeoutMultiplier member and the number of bytes to be written.
A value of zero for both the WriteTotalTimeoutMultiplier and WriteTotalTimeoutConstant members indicates that total time-outs are not used for write operations.



Remarks

If an application sets ReadIntervalTimeout and ReadTotalTimeoutMultiplier to MAXDWORD and sets ReadTotalTimeoutConstant to a value greater than zero and less than MAXDWORD, one of the following occurs when the ReadFile function is called:

· If there are any characters in the input buffer, ReadFile returns immediately with the characters in the buffer.
· If there are no characters in the input buffer, ReadFile waits until a character arrives and then returns immediately.
· If no character arrives within the time specified by ReadTotalTimeoutConstant, ReadFile times out.



See Also

GetCommTimeouts, ReadFile, ReadFileEx, SetCommTimeouts, WriteFile, WriteFileEx


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

COMMTIMEOUTS



Структура COMMTIMEOUTS использована в SetCommTimeouts и функциях GetCommTimeouts, чтобы устанавливать и запросу параметры задержки для устройства связи. Параметры определяют поведение ReadFile, WriteFile, ReadFileEx, и действий WriteFileEx на устройстве.

typedef struct _COMMTIMEOUTS { // ctmo DWORD ReadIntervalTimeout;
DWORD ReadTotalTimeoutMultiplier;
DWORD ReadTotalTimeoutConstant;
DWORD WriteTotalTimeoutMultiplier;
DWORD WriteTotalTimeoutConstant;
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;


Участники

ReadIntervalTimeout

Определяет максимальное время, в течение миллисекунд, допущенных, чтобы истекать между прибытием двух символов на линии связи. В течение действия ReadFile, период времени начинается когда первый символ получен. Если интервал между прибытием любых двух символов превышает эту сумму, операция ReadFile завершена и любые буферные данные возвращаны. Величина нуля указывает, что задержки интервала не использованы.
Величина MAXDWORD, объединенная нулевыми величинами как для ReadTotalTimeoutConstant так и участников ReadTotalTimeoutMultiplier, определяет, что операция чтения должна возвращаться немедленно с символами, что уже получен, даже если бы никакие символы не получены.

ReadTotalTimeoutMultiplier

Определяет множитель, в течение миллисекунд, использованных, чтобы вычислять общий период задержки для операций чтения. Для каждой прочитанной операции, эта величина умножена на запрошенное количество байтов, которые нужно быть прочитаны.

ReadTotalTimeoutConstant

Определяет константу, в течение миллисекунд, использованных, чтобы вычислять общий период задержки для операций чтения. Для каждой прочитанной операции, эта величина добавлена к продукту элемента ReadTotalTimeoutMultiplier и запрошенное количество байтов.
Величина нуля как для ReadTotalTimeoutMultiplier так и участников ReadTotalTimeoutConstant указывает, который составляет задержки не использованы для операций чтения.

WriteTotalTimeoutMultiplier

Определяет множитель, в течение миллисекунд, использованных, чтобы вычислять общий период задержки для записывать операций. Для каждой операции записи, эта величина умножена на количество байтов, которые нужно записывать.

WriteTotalTimeoutConstant

Определяет константу, в течение миллисекунд, использованных, чтобы вычислять общий период задержки для записывать операций. Для каждой операции записи, эта величина добавлена к продукту элемента WriteTotalTimeoutMultiplier и количество байтов, которые нужно записывать.
Величина нуля как для WriteTotalTimeoutMultiplier так и участников WriteTotalTimeoutConstant указывает, который составляет задержки не использованы для записывать операций.



Замечания

Если приложение устанавливает ReadIntervalTimeout и ReadTotalTimeoutMultiplier на MAXDWORD и комплекты ReadTotalTimeoutConstant в величину больше, чем нуль и менее чем MAXDWORD, одно из следующего происходит когда функция ReadFile названа:

Если есть любые символы в входном буфере, возврате ReadFile немедленно с символами в буфере.
Если нет символов в входном буфере, ReadFile ожидается пока символ не прибудет и тогда возвращается немедленно.
Если никакой символ не прибывает в течение времени определенного ReadTotalTimeoutConstant, временем ReadFile.



Смотри Также

GetCommTimeouts, ReadFile, ReadFileEx, SetCommTimeouts, WriteFile, WriteFileEx


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