На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetCommState



The SetCommState function configures a communications device according to the specifications in a device-control block (a DCB structure). The function reinitializes all hardware and control settings, but it does not empty output or input queues.

BOOL SetCommState(

HANDLE hFile, // handle of communications device
LPDCB lpDCB // address of device-control block structure
);


Parameters

hFile

Identifies the communications device. The CreateFile function returns this handle.

lpDCB

Points to a DCB structure containing the configuration information for the specified communications device.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The SetCommState function uses a DCB structure to specify the desired configuration. The GetCommState function returns the current configuration.
To set only a few members of the DCB structure, you should modify a DCB structure that has been filled in by a call to GetCommState. This ensures that the other members of the DCB structure have appropriate values.
The SetCommState function fails if the XonChar member of the DCB structure is equal to the XoffChar member.

When SetCommState is used to configure the 8250, the following restrictions apply to the values for the DCB structure's ByteSize and StopBits members:

· The number of data bits must be 5 to 8 bits.
· The use of 5 data bits with 2 stop bits is an invalid combination, as are 6, 7, or 8 data bits with 1.5 stop bits.



See Also

BuildCommDCB, CreateFile, DCB, GetCommState


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetCommState



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

BOOL SetCommState(

РУЧКА hFile, // ручка устройства связи LPDCB lpDCB // адрес устройства-управления блокируют структуру
);


Параметры

hFile

Идентифицирует устройство связи. Функция CreateFile возвращает эту ручку.

lpDCB

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



Обратные Величины

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

Замечания

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

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

Номер битов данных должен быть 5 на 8 битов.
Использование 5 данных сцепляется с 2 стоповыми битами - неправильная комбинация, что - 6, 7, или 8 битов данных с 1.5 стоповыми битами.



Смотри Также

BuildCommDCB, CreateFile, DCB, GetCommState


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz