Функция SetCommState

Функция SetCommState конфигурирует коммуникационное устройство согласно определениям в управляющем устройством блоке (структура DCB). Функция повторно инициализирует все аппаратные и управляющие настройки, но не опорожняет очереди вывода или ввода данных.

Синтаксис

BOOL SetCommState(
  HANDLE hFile,
  LPDCB lpDCB
);

Параметры

hFile

[in] Дескриптор коммуникационного устройства. Функцией CreateFile возвращается этот дескриптор.

lpDCB

[in] Указатель на структуру DCB, которая содержит информацию о конфигурации заданного коммуникационного устройства.

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

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

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

Замечания

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

Чтобы установить только несколько членов структуры DCB, вам следует изменить структуру DCB, которая заполнялась вызовом функции GetCommState. Это гарантирует то, что остальные члены структуры DCB имеют соответствующие значения.

Функция SetCommState завершается ошибкой, если член XonChar структуры DCB равен XoffChar члену этой же структуры.

Когда используется функция SetCommState , чтобы конфигурировать 8250, к значениям членов ByteSize и StopBits структуры DCB применяют ниже перечисленные ограничения:

Число битов данных должно быть 5 - 8 битов.

Код примера

Смотри также

Размещение и совместимость SetCommState
К	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	-
	Замечания по платформе	Не имеется