Функция 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, с ниже перечисленными исключениями:

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

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

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

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.

 

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz