Структура 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