Шрифт:
В случае успешного завершения функция BuildCommDCB возвращает не нулевое значение. В случае ошибки возвращается 0.
Обычно функция BuldCommDCB изменяет только явно перечисленные в строке lpDef поля. Однако существуют два исключения из этого правила:
• При задании скорости обмена 110 бит в секунду автоматически устанавливается формат обмена с двумя стоповыми битами. Это сделано для совместимости с командой mode из MS-DOS или Windows NT.
• По умолчанию запрещается программное (XON/XOFF) и аппаратное управление потоком. Вы должны вручную заполнить требуемые поля DCB если требуется управление потоком.
Функция BuilCommDCB поддерживает как новый, так и старый форматы командной строки mode. Однако, Вы не можете смешивать эти форматы в одной строке.
Новый формат строки позволяет явно задавать значения для полей DCB отвечающих за управление потоком. При использовании старого формата существуют следующие соглашения:
— Для строк вида 9600,n,8,1 (не заканчивающихся символами х или р):
• flnX, fOutX,fOutXDsrFlow, fOutXCtsFlow устанавливаются в FALSE
• fDtrControl устанавливается в DTR_CONTROL_ENABLE
• fRtsControl устанавливается в RTS_CONTROL_ENABLE
— Для строк вида 9600,n,8,1,х (заканчивающихся символом х):
• flnX, fOutX устанавливаются в TRUE
• fOutXDsrFlow,fOutXCtsFlow устанавливаются в FALSE
• fDtrControl устанавливается в DTR_CONTROL_ENABLE
• fRtsControl устанавливается в RTS_CONTROL_ENABLE
— Для строк вида 9600,n,8,1,р (заканчивающихся символом р):
• flnX, fOutX устанавливаются в FALSE
• fOutXDsrFlow,fOutXCtsFlow устанавливаются TRUE
• fDtrControl устанавливается в DTR_CONTROL_HANDSHAKE
• fRtsControl устанавливается в RTS_CONTROL_HANDSHAKE
Следует заметить, что функция BuildCommDCB только заполняет поля DCB указанными значениями. Это подготовительный шаг к конфигурированию порта, но не само конфигурирование, которое выполняется рассматриваемыми далее функциями. Поэтому Вы можете вызвать BuildCommDCB для общего заполнения структуры DCB, затем изменить значения не устраивающих Вас полей, и после этого вызывать функцию конфигурирования порта.
Функция GetCommState
Заполнить DCB можно еще одним способом. Вызовом функции GetCommState. Эта функция заполняет DCB информацией о текущем состоянии устройства, точнее о его настройках. Вот как она выглядит:
BOOL GetCommState(
HANDLE hFile,
LPDCB lpDCB
);
Функция очень проста и имеет всего два параметра:
• hFile
Описатель открытого файла коммуникационного порта. Этот описатель возвращается функцией CreateFile. Следовательно, прежде чем получить параметры порта, Вы должны его открыть. Для функции BuildCommDCB это не требовалось.
• lpDCB
Указатель на DCB. Для DCB должен быть выделен блок памяти.
При успешном завершении функция возвращает ненулевое значение. При ошибке нуль. Получить параметры порта можно в любой момент, а не только при начальной настройке.
Функция SetCommState
Заполнив DCB можно приступать к собственно конфигурированию порта. Это делается с помощью функции SetCommState:
BOOL SetCommState(
HANDLE hFile,
LPDCB lpDCB
);
Эта функция имеет точно такие же параметры, как GetCommState. Различается только направление передачи информации. GetCommState считывает информацию из внутренних управляющих структур и регистров порта, а SetCommState наоборот заносит ее. Следует быть осторожным при вызове функции SetCommState, поскольку она изменит параметры даже в том случае, если очереди приема/передачи не пусты, что может вызвать искажение потока передаваемых или принимаемых данных.
Еще одна тонкость этой функции заключается в том, что она завершится с ошибкой, если поля XonChar и XoffChar в DCB содержат одинаковые значения.
Как всегда, в случае успешного завершения возвращается отличное от нуля значение, а в случае ошибки — нуль.
Структура COMMTIMEOUTS
Следующей важной управляющей структурой является COMMTIMEOUTS. Она определяет параметры временных задержек при приеме и передаче. Значения, задаваемые полями этой структуры, оказывают большое влияние на работу функций чтения/записи.