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

Статья
03/03/2024

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

Синтаксис

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

Параметры

[in] hFile

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

[in] lpDCB

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

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

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

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

Чтобы задать только несколько элементов структуры 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