SetupComm

9/8/2008

Essa função inicializa os parâmetros de comunicação para um dispositivo de comunicação especificada.

Syntax

BOOL SetupComm(
  HANDLE hFile,
  DWORD dwInQueue,
  DWORD dwOutQueue
);

Parameters

• hFile
  [no] Identificador para o dispositivo de comunicação retornado pela função a CreateFile.

• dwInQueue
  [no] Especifica o tamanho recomendado, em bytes, do buffer de entrada interno do dispositivo.

• dwOutQueue
  [no] Especifica o tamanho recomendado, em bytes, de reserva saída interno do dispositivo de.

Return Value

Sempre retorna FALSE porque o tamanho de FILA fila não pode ser alterado. Para obter informações de erro estendidas, chamar GetLastError.

Remarks

Após um processo usa o CreateFile função para aberto um identificador para um dispositivo de comunicação, ele pode chamar SetupComm Para definir os parâmetros de comunicação para o dispositivo. Se ele não defini-los, o dispositivo usa os parâmetros usar como padrão quando ocorre o primeiro chamar a outra função de comunicação.

1. O dwInQueue e dwOutQueue especificar parâmetros os tamanhos recomendados para os buffers internos usados pelo driver para o dispositivo especificado. De exemplo, YMODEM protocolo pacotes forem ligeiramente maior do que 1024 bytes. Portanto, um tamanho do buffer recomendadas podem ser 1200 bytes para comunicação YMODEM.

O driver de dispositivo recebe os tamanhos reserva recomendado, mas está livre para usar qualquer buferização E/S esquema desde que ele fornece desempenho razoável e dados perdida não devido a saturação (exceto em circunstâncias extremas).

De exemplo, a função pode bem-sucedida mesmo que o driver não aloca uma reserva, desde que alguma outra parte do sistema fornece equivalente a funcionalidade.

Requirements

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

See Also

Reference

Serial Communications Functions
SetCommState

Other Resources

CreateFile