WinAPI на русском

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".

Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php

Обновления на сайте

Нет.

Перевод

Сегодня вашему вниманию представлен перевод функции BuildCommDCB.

BuildCommDCB
Функция BuildCommDCB заполняет указанную DCB structure структуру значениями,
указанными в командной строке устройства. Командная строка управления устройством
использует синтаксис командного режима .

BOOL BuildCommDCB(
  LPCTSTR lpDef,  // указатель на строку регулировки устройства
  LPDCB lpDCB     // указатель на структуру DCB
);
Параметры
lpDef 
[in] Указатель на строку с нулевым символом в конце, которая определяет информацию
регулировки устройства. Строка должна иметь ту же самую форму, что и параметры
командной строки в командном режиме. Например, следующая строка определяет скорость
в бодах равную 1200, отсутствие проверки на четность, 8 битов данных и 1 стоп–бит:

baud=1200 parity=N data=8 stop=1 
Если имя устройства включено в строку то оно игнорируется, но это имя должно
определять существующее устройство: 

COM1: baud=1200 parity=N data=8 stop=1 
Для дальнейшей информации относительно синтаксиса команды режима, обратитесь
к документации для вашей операци-онной системы.

lpDCB 
[out] Указатель на структуру DCB , которая будет заполнена. 
Возвращаемые значения
Если функция выполнена без ошибок, возвращаемое значение отлично от нуля.

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

Примечания
Функция BuildCommDCB корректирует только те члены структуры DCB, на которые определенно
воздействует пара-метр lpDef , со следующими исключениями: 

Если указанная скорость в бодах равна 110, то функция устанавливает количество
стоп–бит равным 2, для совмести-мости с командным режимом Windows NT или MS-DOS.

По умолчанию BuildCommDCB блокирует и XON/XOFF, и аппаратное управление потоком
данных. Для разреше-ния управления потоком данных, Вы должны явно установить
соответствующие члены структуры DCB . 
Функция BuildCommDCB только заполняет структуру DCB. Чтобы применить эти параметры
настройки для последо-вательного порта используйте функцию SetCommState . 

Имеются старые и новые формы синтаксиса командного режима. Функция BuildCommDCB
поддерживает обе формы. Однако Вы не можете смешивать две формы вместе.

Более новая форма синтаксиса командного режима позволяет Вам явно устанавливать
значения членов управления по-током данных структуры DCB. Если Вы используете
старую форму синтаксиса режима, функция BuildCommDCB устанавливает членов управления
потоком данных структуры DCB , следующим образом: 

Для строки типа 96,n,8,1 или любой другой старой формы командной строки, которая
не заканчивается на x или p: 
fInX, fOutX, fOutXDsrFlow, и fOutXCtsFlow все установлены в FALSE 

fDtrControl установлен в DTR_CONTROL_ENABLE 

fRtsControl установлен в RTS_CONTROL_ENABLE

Для строки типа 96,n,8,1,x или любой другой старой формы командной строки, которая
заканчивается на x: 
fInX и fOutX оба установлены в TRUE 

fOutXDsrFlow и fOutXCtsFlow оба установлены в FALSE 

fDtrControl установлен в DTR_CONTROL_ENABLE 

fRtsControl установлен в RTS_CONTROL_ENABLE

Для строки типа 96,n,8,1,p или любой другой старой формы командной строки, которая
заканчивается на p: 
fInX и fOutX оба установлены в FALSE 

fOutXDsrFlow и fOutXCtsFlow оба установлены в TRUE 

fDtrControl установлен в DTR_CONTROL_HANDSHAKE 

fRtsControl установлен в RTS_CONTROL_HANDSHAKE

Требования 
  Windows NT/2000/XP: Требуется NT 3.1 или более поздняя версия.
  Windows 95/98: Требуется Windows 95 или более поздняя версия.
  Заголовочный файл: Определено в Winbase.h; Подключать Windows.h.
  Библиотека: Использовать Kernel32.lib.
  Unicode: Unicode: Поддерживается как Unicode так и ANSI версии под Windows
NT/2000.

Смотри также
DCB, SetCommState 

Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn

С уважением, 
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@ua.fm