Функция BuildCommDCB

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

Синтаксис

BOOL BuildCommDCB(
  LPCTSTR lpDef,
  LPDCB lpDCB
);

Параметры

lpDef

[in] Указатель на символьную строку с нулем в конце, которая определяет информацию управления устройством. Функция берет эту строку, анализирует ee, а затем устанавливает соответствующие значения в структуре DCB, на которую указывает параметр lpDCB.

Строка должна иметь такую же форму как и параметры командной строки команды mode. Например, строка ниже определяет скорость передачи данных в бодах 1200, отсутствие контроля по четности, 8 битов данных и 1 стоповый бит:

baud=1200 parity=N data=8 stop=1

Имя устройства игнорируется, если оно включается в строку, но оно должно определять допустимое устройство, как следует ниже:

COM1: baud=1200 parity=N data=8 stop=1

Для получения дополнительной информации о mode, см. документацию вашей операционной системы.

lpDCB

[out] Указатель на структуру DCB, которая принимает информацию.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение не нуль.

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

Замечания

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

Если заданная скорость передачи данных в бодах равна 110, функция устанавливает стоповые биты до 2, чтобы остаться совместимой с системной командой mode.
По умолчанию, BuildCommDCB отключает XON/XOFF и аппаратное управление потоком данных. Чтобы включить управление потоком данных, Вы должны явно установить соответствующие члены структуры DCB.

Функция BuildCommDCB только заполняет члены в структуре DCB. Чтобы применить эти назначения для последовательного порта, используйте функцию SetCommState.

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

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

Строка типа 96, n, 8,1 или любая другая строка mode старой формы, которая не заканчивается x или p:
fInX, fOutX, fOutXDsrFlow и fOutXCtsFlow все устанавливаются в FALSE
fDtrControl устанавливается в DTR_CONTROL_ENABLE
fRtsControl устанавливается в RTS_CONTROL_ENABLE
Строка типа 96, n, 8,1 или любая другая строка mode старой формы, которая заканчивается x:
fInX и fOutX оба параметра устанавливаются в TRUE
fOutXDsrFlow и fOutXCtsFlow оба параметра устанавливаются в FALSE
fDtrControl устанавливается в DTR_CONTROL_ENABLE
fRtsControl устанавливается в RTS_CONTROL_ENABLE
Строка типа 96, n, 8,1 или любая другая строка mode старой формы, которая заканчивается p:
fInX и fOutX оба параметра устанавливаются в FALSE
fOutXDsrFlow и fOutXCtsFlow оба параметра устанавливаются в TRUE
fDtrControl устанавливается в DTR_CONTROL_HANDSHAKE
fRtsControl устанавливается в RTS_CONTROL_HANDSHAKE

Windows Me/98/95: BuildCommDCBW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, DCB, SetCommState

Размещение и совместимость BuildCommDCB
К	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	Реализуется как версии Unicode и ANSI. Обратите внимание!, что поддержка Windows Me/98/95 требует программы Microsoft Layer for Unicode.
	Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

В оглавление справки