Шрифт:
Параметры функции следующие:
• hCommDev
Описатель открытого коммуникационного порта.
• IpCC
Адрес выделенного и заполненного нулями, кроме поля dwSize, блока памяти под структуру COMMCONFIG. В поле dwSize нужно занести размер структуры COMMCONFIG. После вызова функции все поля структуры будут содержать информацию о текущих параметрах порта.
• IpdwSize
Адрес двойного слова, которое после возврата из функции будет содержать число фактически переданных в структуру байт.
В случае успешного завершения функция возвращает ненулевое значение.
Как всегда не обошлось без тонкостей. Структура COMMPROP имеет переменную длину, поэтому затруднительно сразу выделить требуемый блок памяти. Как и в случае с функцией GetCommProperties, функцию GetCommConfig придется вызывать дважды:
…
COMMCONFIG *cf;
DWORD sz;
HANDLE port;
…
сf=(COMMCONFIG*)HeapAlloc(GetProcessHeap,HEAP_ZERO_MEMORY,sizeof(COMMCONFIG));
cf->dwSize=sizeof(COMMCONFIG);
GetCommConfig(port,cf,&sz);
if(sz > sizeof(COMMCONFIG)) {{
сf=(COMMCONFIG*)HeapRealloc(GetProcessHeap,HEAP_ZERO_MEMORY,cf,sz);
cf->dwSize=sz;
GetCommConfig(port,cf,&sz);
};
...
HeapFree(GetProcessHeap,0,cf);
CloseHandle(port);
…
Функция CommConfiaDialoa
Теперь, имея заполненую корректной информацией структуру COMMCONFIG, можно позволить пользователю выполнить настройку параметров с помощью функции CommConfigDialog:
BOOL CommConfigDialog(
LPTSTR IpszName,
HWND hWnd,
LPCOMMCONFIG IpCC
);
Вызов этой функции приводит к отображению примерно такого диалогового окна:
Вид окна может отличаться от приведенного. Это зависит от операционной системы и динамической библиотеки, предоставленной производителем порта.
Познакомимся с параметрами функции CommConflgDialng:
• IpszName
Указатель на строку с именем порта, для которого отображается диалоговое окно. К реальному имени порта эта строка не имеет никакого отношения, она просто выводится в заголовке окна.
• hWnd
Описатель окна, которое владеет данным диалоговым окном. Должен быть передан корректный описатель окна-владельца или NULL, если у диалогового окна нет владельца.
• IpCC
Указатель на структуру COMMCONFIG. Эта структура содержит начальные установки, используемые для отображения в диалоговом окне, и установленные пользователем изменения, при завершении диалога.
Как и большинство других функций Win32 API, функция CommConfigDialog возвращает отличное от нуля значение, в случае успешного завершения, и нуль, если возникла ошибочная ситуация.
Функция CommConfigDialog не выполняет настройки порта. Она все лишь позволяет пользователю изменить некоторые поля в блоке DCB, содержащемся в структуре COMMCONFIG. Разумеется, Вы можете изменить установленные пользователем некорректные значения или выполнить дополнительные настройки после вызова функции GetCommConfig.
Функция SetCommConfig
Фактическая настройка порта выполняется функцией SetCommConfig:
BOOL SetCommConfig(
HANDLE hCommDev,
LPCOMMCONFIG IpCC,
DWORD dwSize
);
Параметры имеют то же самое значение, как и в функции GetCommConfig. Следует заметить, что описанные три функции позволяют настраивать и некоторые параметры модема, если он подключен к порту и опознан системой. Впрочем, эта возможность может отсутствовать, если она не предусмотрена производителем оборудования.
Функции GetDefaultCommConfig и SetDegaultCommConfig