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.
- 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