COMMTIMEOUTS

9/8/2008

Essa estrutura é usada na SetCommTimeouts e GetCommTimeouts funções para consulta e definir os parâmetros tempo limite para um dispositivo de comunicação.

Os membros determinam o comportamento do ReadFile e WriteFile função operações no dispositivo.

Syntax

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

Os membros

• ReadIntervalTimeout
  Especifica o tempo máximo aceitável, em milissegundos, para decorrer entre a chegada de dois caracteres na linha de comunicação.

  Em Windows Embedded CE, durante um ReadFile operação, o período de tempo começa imediatamente.

  Se o intervalo entre as entradas de dois caracteres excede a quantidade tempo especificada em ReadIntervalTimeout, o ReadFile operação for concluída e armazenada em buffer dados serão retornados.

  Um valor de zero indica que tempos limite intervalo não estão sendo usadas.

• ReadTotalTimeoutMultiplier
  Especifica o multiplicador, em milissegundos, usados para calcular o total tempo limite para ler as operações.

  Para cada operação de leitura, esse valor é multiplicado pelo número solicitado de bytes a ser ler.

• ReadTotalTimeoutConstant
  Especifica a constante, em milissegundos, usados para calcular o total tempo limite para ler as operações.

  Para cada operação de leitura, esse valor é adicionado ao produto das ReadTotalTimeoutMultiplier membro e o número solicitado de bytes.

  Um valor de zero para o ReadTotalTimeoutMultiplier e ReadTotalTimeoutConstant Membros indica que o total de tempos limite não é usado para ler as operações.

• WriteTotalTimeoutMultiplier
  Especifica o multiplicador, em milissegundos, usados para calcular que o tempo limite total para operações de gravação.

  Para cada operação de gravação, esse valor é multiplicado pelo número de bytes a serem gravados.

• WriteTotalTimeoutConstant
  Especifica a constante, em milissegundos, usada para calcular que o tempo limite total para operações de gravação.

  Para cada operação de gravação, esse valor é adicionado ao produto das WriteTotalTimeoutMultiplier membro e o número de bytes a serem gravados.

  Um valor de zero para o WriteTotalTimeoutMultiplier e WriteTotalTimeoutConstant Membros indica que tempos limite total não é usada para operações de gravação.

Remarks

Se um aplicativo define ReadIntervalTimeout e ReadTotalTimeoutMultiplier Para MAXDWORD e conjuntos ReadTotalTimeoutConstant Para um valor maior que zero e menor que MAXDWORDdesses, o seguinte ocorre quando o ReadFile função é chamado:

• Se houver caracteres no buffer de entrada, ReadFile retorna imediatamente com os caracteres de reserva.
• Não se houver nenhum caractere no buffer de entrada, ReadFile Aguarda até que um caractere chega e, em seguida, retorna imediatamente.
• Se nenhum caractere chegarem dentro de tempo especificado pelo ReadTotalTimeoutConstant, ReadFile Tempo limite.

Requirements

Header	winbase.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Serial Communications Structures
GetCommTimeouts
SetCommTimeouts

Other Resources

ReadFile
WriteFile