Структура COMMTIMEOUTS

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

Синтаксис

typedef struct _COMMTIMEOUTS {
  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, происходит одно из ниже перечисленного:

Смотри также

Обзор Коммуникационные ресурсы, Структуры, используемые коммуникационными ресурсами, GetCommTimeouts, ReadFile, ReadFileEx, SetCommTimeouts, WriteFile, WriteFileEx

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

К

Windows. NET Server

-

л

Windows XP

Да

и

Windows 2000 Professional

Да

е

Windows NT Workstation

Да 

н

Windows Me

Да

т

Windows 98

Да

 

Windows 95

Да

 
С

Windows 2003 Server

Да
е

Windows 2000 Server

Да 
р

Windows NT Server

Да 
в

 

 
е

 

 
р 

 

 
 

Используемая библиотека

-

 

Заголовочный файл

 
 

- объявлено в

Winbase.h

 

- включено в

Windows.h

 

Unicode

Реализуется как версии Unicode и  ANSI. Обратите внимание!, что поддержка Windows Me/98/95 требует программы Microsoft Layer for Unicode.

 

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

Не имеется

 

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

Hosted by uCoz