Функция SetupComm инициализирует коммуникационные параметры для заданного коммуникационного устройства.
Синтаксис
BOOL SetupComm( HANDLE hFile, DWORD dwInQueue, DWORD dwOutQueue ); |
Параметры
hFile
[in] Дескриптор коммуникационного устройства. Функция CreateFile возвращает этот дескриптор.dwInQueue
[in] Рекомендуемый размер внутреннего буфера ввода данных устройства, в байтах.dwOutQueue
[in] Рекомендуемый размер внутреннего буфера вывода данных устройства, в байтах.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Процесс, после того, как использует функцию CreateFile, чтобы открыть дескриптор коммуникационного устройства, но перед выполнением любого ввода - вывода (I/O) устройством, может вызвать SetupComm, чтобы установить коммуникационные параметры для устройства. Если он не устанавливает их, устройство использует параметры заданные по умолчанию, когда произошел первый вызов другой коммуникационной функции.
Параметры dwInQueue и dwOutQueue определяют рекомендованные размеры для внутренних буферов, используемых драйвером для указанного устройства. Например, пакеты протокола YMODEM являются немного большими чем 1024 байта. Поэтому, рекомендованный размер буфера может быть 1200 байтов для коммуникаций YMODEM. Для коммуникаций, имеющих в основе Ethernet, рекомендованный размер буфера может быть 1600 байтов, который является немного большим, чем отдельно взятый фрейм Ethernet.
Драйвер устройства получает рекомендованные размеры буфера, но освобождается от использования любой схемы буферизации ввода - вывода (I/O) данных до тех пор, пока это обеспечивает разумную производительность, а данные не теряются из-за переполнения буфера (исключая ситуации при чрезвычайных обстоятельствах). Например, функция может завершиться успешно даже при том, что драйвер не назначает буфер, до тех пор, пока какая-либо другая часть системы не произведет эквивалентное выполнение функций.
Смотри также
Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, CreateFile, SetCommState
|
Размещение и совместимость SetupComm |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
|
т |
Windows 95 |
Да |
| С |
Windows 2003 Server |
Да |
| е |
Windows 2000 Server |
Да |
| р |
Windows NT Server |
Да |
| в |
|
|
| е |
|
|
| р |
|
|
|
Используемая библиотека |
Kernel32.lib |
|
|
Заголовочный файл |
||
|
- объявлено в |
Winbase.h |
|
|
- включено в |
Windows.h |
|
|
Unicode |
- |
|
|
Замечания по платформе |
Не имеется |
|