Поделиться через


Функция SetCommState (winbase.h)

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

Синтаксис

BOOL SetCommState(
  [in] HANDLE hFile,
  [in] LPDCB  lpDCB
);

Параметры

[in] hFile

Дескриптор для устройства связи. Функция CreateFile возвращает этот дескриптор.

[in] lpDCB

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

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

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

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

Комментарии

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

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

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

Если для настройки 8250 используется SetCommState, к значениям элементов ByteSize и StopBits структуры DCB применяются следующие ограничения:

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

Примеры

Пример см. в разделе Настройка ресурса связи.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

BuildCommDCB

Функции связи

Информационные ресурсы

CreateFile

DCB

GetCommState