Функция 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 битов.

Код примера

Пример смотри в статье Конфигурация коммуникационного ресурса.

Смотри также

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

Размещение и совместимость 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

-

 

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

Не имеется

 

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

Hosted by uCoz