На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetupComm



The SetupComm function initializes the communications parameters for a specified communications device.

BOOL SetupComm(

HANDLE hFile, // handle of communications device
DWORD dwInQueue, // size of input buffer
DWORD dwOutQueue // size of output buffer
);


Parameters

hFile

Identifies the communications device. The CreateFile function returns this handle.

dwInQueue

Specifies the recommended size, in bytes, of the device's internal input buffer.

dwOutQueue

Specifies the recommended size, in bytes, of the device's internal output buffer.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

After a process uses the CreateFile function to open a handle to a communications device, it can call SetupComm to set the communications parameters for the device. If it does not set them, the device uses the default parameters when the first call to another communications function occurs.
The dwInQueue and dwOutQueue parameters specify the recommended sizes for the internal buffers used by the driver for the specified device. For example, YMODEM protocol packets are slightly larger than 1024 bytes. Therefore, a recommended buffer size might be 1200 bytes for YMODEM communications. For Ethernet-based communications, a recommended buffer size might be 1600 bytes, which is slightly larger than a single Ethernet frame.

The device driver receives the recommended buffer sizes, but is free to use any input and output (I/O) buffering scheme, as long as it provides reasonable performance and data is not lost due to overrun (except under extreme circumstances). For example, the function can succeed even though the driver does not allocate a buffer, as long as some other portion of the operating system provides equivalent functionality.
If the device driver determines that the recommended buffer sizes involve transfers beyond its ability to handle, the function can fail.

See Also

CreateFile, SetCommState


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetupComm



Функция SetupComm инициализирует параметры связи для определенного устройства связи.

BOOL SetupComm(

РУЧКА hFile, // ручка устройства связи DWORD dwInQueue, // размера вклада буферизуют размер DWORD dwOutQueue // выходного буфера
);


Параметры

hFile

Идентифицирует устройство связи. Функция CreateFile возвращает эту ручку.

dwInQueue

Определяет рекомендуемый размер, в байтах, внутреннего входного буфера устройства.

dwOutQueue

Определяет рекомендуемый размер, в байтах, внутреннего выходного буфера устройства.



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

После того, как процесс использует функцию CreateFile, чтобы открывать ручку на устройство связи, он может назвать SetupComm, чтобы устанавливать параметры связи для устройства. Если это не делает устанавливать им, устройство использует по умолчанию параметры когда первый вызов в другую функцию связи происходит.
dwInQueue И параметры dwOutQueue определяют рекомендуемые размеры для внутренних буферов использованных драйвером для определенного устройства. Например, пакеты протокола YMODEM немного большие чем 1024 байта. Следовательно, рекомендуемый буферный размер мог быть 1200 байтов для связи YMODEM. Для базирующейся связи Ethernet, рекомендуемый буферный размер мог быть 1600 байтов, которые немного большие чем единственный фрейм Ethernet.

Драйвер устройства получает рекомендуемые буферные размеры, но свободн, чтобы использовать любой ввод и выход (В/В) буферизуя схему, так же долго (длиной) как это обеспечивает разумное исполнение и данные не потерены из-за выходить за границы (кроме при крайних обстоятельствах). Например, функция может добиться успеха даже если драйвер не распределяет буфер, так же долго (длиной) как некоторая другая часть операционной системы обеспечивает эквиалентное функциональное назначение.
Если драйвер устройства определяет, что рекомендуемые буферные размеры включают передачи за своей способностью оперироваться, функция может потерпеть неудачу.

Смотри Также

CreateFile, SetCommState


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz