Другое: Интегрированная среда моделирования РДО

________________________________________ ________________________________

Описание библиотеки для работы с драйвером электронных ключей

________________________________________ ________________________________

Инструменты для работы с драйверами из приложения пользователя находятся

в библиотеке INSTDRV.DLL. В приложения, использующие данную DLL, необходимо

включать файлы INSTDRVS.H и INSTDRVF.H.

В данном каталоге содержатся следующие файлы:

INSTDRV.DLL - Библиотека функций для работы с драйвером

INSTDRVF.H - Файл-заголовок с описанием функций

INSTDRVS.H - Файл-заголовок с описанием структуры и кодов возврата

README.TXT - Этот файл

Файлы для примера:

MK_DEMO.BAT - Командный файл для трансляции

INSTDEMO.MAK - MAKE-файл для трансляции

INSTDEMO.IDE - Проектный файл ( создан на Borland C++ 5.02 )

INSTDRV.C - Исходный текст ( основной модуль )

DIALOG.C - Исходный текст ( дополнительный модуль )

INSTDRV.H - Файл-заголовок

INSTSTR.H - Файл-заголовок с описанием констант для строчных ресурсов

INSTDRV.RC - Ресурсы

INSTDRV.LIB - Библиотека импорта для INSTDRV.DLL (Borland)

INSTDMS.LIB - Библиотека импорта для INSTDRV.DLL (Microsoft)

INSTDRV.ICO - Иконка програмы

Пример использования библиотеки - полностью фукциональная утилита для

работы с драйвером. Странслировав этот пример Вы получите поставляемую

с нашими драйверами утилиту установки. Единственное отличие между ними

будет заключаться в том, что в примере используется внешняя DLL, а в

утилите установки все функции включены в ЕХЕ-файл.

ВНИМАНИЕ! Для работы примера (как и для утилиты) необходимо, чтобы в

текущем каталоге находились файлы драйвера.

________________________________________ ______________________________________

"""""""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""""

Описание библиотеки INSTDRV.DLL

________________________________________ ______________________________________

"""""""""""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""""""""

//////////////////////////////////////// //////////////

ЭКСПОРТИРУЕМЫЕ ФУНКЦИИ *

Описание находится в файле INSTDRVF.H

\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ \\\\\\\\\\\\\\

* Все функции предназначены для работы как в Windows 95/98,

так и в Windows NT/2000

______________________________

int WINAPI GD_ReInstallDriver ( void );

Input -

Return - Код ошибки

Устанавливает свежую версию драйвера. Если драйвер уже находился в системе,

то происходит переустановка.

Существовавшая ранее конфигурация сохраняется.

____________________________

int WINAPI GD_InstallDriver ( void );

Input -

Return - Код ошибки

Устанавливает драйвер в систему.

Если драйвер уже установлен, то возвращается ge_DRIVER_ALREADY_INSTALLED

___________________________

int WINAPI GD_RemoveDriver ( BOOL bSaveConfig );

Input - Признак: сохранять ли конфигурацию

Return - Код ошибки

Удаляет драйвер из системы.

При bSaveConfig == TRUE конфигурация драйвера не удаляется из системного

реестра. В этом случае при последущей установке драйвера будет использована

уже существующая конфигурация.

При bSaveConfig == FALSE конфигурация стирается.

В Windows 95 после выполнения процедуры необходима перезагрузка,

т.к. драйвер остается в памяти и продолжает функционировать

__________________________

int WINAPI GD_CheckDriver ( PGD_DRIVER_INFO pDI, DWORD dwSize );

Input - Указатель на буфер для информации о драйвере

Размер буфера

Return - Код ошибки

Если код ошибки равен ge_NO_ERROR, то в буфер помещается структура с

полной информацией о текущем состоянии драйвера.

Описание полей структуры GD_DRIVER_INFO см. ниже.

________________________________

int WINAPI GD_ConfigSetDefaults ( void );

Input -

Output - Код ошибки

Устанавливает конфигурацию драйвера по умолчанию.

Значения по умолчанию берутся из файла INSTDRV.INI

Для активизации изменений в конфигурации драйвера необходим

вызов процедуры GD_ReconfigureDriver()

_____________________________

int WINAPI GD_ConfigPortsUse ( BYTE PortsMask );

Input - Маска используемых портов

Output - Код ошибки

Устанавливает порты, в которых будет производиться поиск электронного ключа

Маска задается как сумма gd_USE_PORT_LPT#

Для активизации изменений в конфигурации драйвера необходим

вызов процедуры GD_ReconfigureDriver()

______________________________

int WINAPI GD_ConfigPortAlloc ( BYTE Port, DWORD Method );

Input - Номер порта

Маска способа захвата

Output - Код ошибки

Устанавливает комбинацию способов захвата для указаного порта

Номер порта задается константой gd_PORT_LPT#

Способ захвата задается как сумма необходимых констант gd_METHOD_#######

Для активизации изменений в конфигурации драйвера необходим

вызов процедуры GD_ReconfigureDriver()

____________________________

int WINAPI GD_ConfigTimeOut ( DWORD TimeOut );

Input - Время ожидания в милисекундах (1/1000 секунды)

Output - Код ошибки

Устанавливает общее время, которое драйвер пытатся захватить порт

По истечению этого времени драйвер возвращает ошибку PORT_BUSY

Значение должно быть от 1 до 600000 (от 0.001 до 600 секунд)

Для активизации изменений в конфигурации драйвера необходим

вызов процедуры GD_ReconfigureDriver()

_________________________

int WINAPI GD_ConfigIrql ( BYTE Port, BYTE Irql );

Input - Номер порта,

Значение IRQL

Output - Код ошибки

Устанавливает значение IRQL при использовании для данного

порта соответствующего способа захвата gd_METHOD_IRQL

Номер порта задается константой gd_PORT_LPT#

Значение IRQL должно находиться в пределах от 0 до 26

Для активизации изменений в конфигурации драйвера необходим

вызов процедуры GD_ReconfigureDriver()

* Только для Windows NT/2000

(в Windows 95/98 тоже работает, но ни на что не влияет)

________________________________

int WINAPI GD_ReconfigureDriver ( void );

Input -

Output - Код ошибки

Производит фактическое переконфигурирование драйвера.

Данную процедуру необходимо вызывать после того, как все необходимые

параметры драйвера установлены.

Процедура переконфигурирует все параметры драйвера, заданые с помощью

процедур GD_Config###### в текущей сессии приложения.

______________________________

void WINAPI GD_SetMessageMode ( BOOL bShowMessages, BOOL bShowFullDescriptions );

Input - Признак: выводить сообщения?

Признак: выводить подробные сообщения?

Output -

!!! Эта функция только для совместимости в предыдущими версиями

---------------------------------------- ---------------------------

- INSTDRV.EXE -

- Утилита установки драйверов для электронных ключей Guardant -

---------------------------------------- ---------------------------

Так как работа утилиты установки во многом схожа в Windows 95 и Window NT,

данный файл содержит подробное описание для обеих операционных систем

с указанием всех различий.

В момент запуска программы следующие файлы должны находится в том же

каталоге, что и INSTDRV.EXE:

Windows 95/98: NVKEY95.VX_ - Драйвер Windows 95/98

INSTDRV.INI - Установки по умолчанию

Windows NT: NVKEYNT.SYS - Драйвер ядра Windows NT/2000

NVKEYVDD.DLL - Виртуальный драйвер (для DOS)

NVKEY4NT.SYS - DOS драйвер устройства

INSTDRV.INI - Установки по умолчанию

При запуске программа INSTDRV.EXE выдаст на экран главное окно.

При запуске INSTDRV проверит наличие в системе драйвера Guardant

Если драйвер не найден, в окне будет доступна только 1-я кнопка, и она

будет называться [Установить драйвер].

--------------------------

- УСТАНОВКА ДРАЙВЕРА -

--------------------------

Для установки драйвера Guardant (или замены уже установленного драй-

вера его более новой версией) нажмите кнопку [Установить(Переустано-

вить)]. При его успешной установке INSTDRV выдаст соответствующее со-

общение, после чего произойдет возврат в главное окно.

---------------------------------------- ---------------------

ВАЖНО !!!

Во время установки драйверов ВСЕ приложения и

особенно DOS сессии должны быть закрыты !

В противном случае возможны ошибки разделения

файлов!

Для Windows NT/2000 также необходимо, чтобы

Пользователь, который работает с утилитой уста-

новки, обладал правами АДМИНИСТРАТОРА системы.

Для пользователей с обычными правами Windows NT

запрещает операции установки, удаления и конфи-

гурирования драйверов

---------------------------------------- ---------------------

--------------------------------

- КОНФИГУРИРОВАНИЕ ДРАЙВЕРА -

--------------------------------

Вы можете настроить параметры работы установленного в систему

драйвера Guardant. Для этого в главном окне INSTDRV нажмите кнопку

[Конфигурирование драйвера].

Процесс конфигурирования драйвера состоит из

- задания портов для поиска ключа

- задания способов захвата порта

- установки таймаута

- дополнительных настроек (рекомендуется их НЕ ТРОГАТЬ!)

Задание портов для поиска ключа

-------------------------------

В левой верхней части окна отображается список найденных на Ва-

шем компьютере параллельных портов. Вы можете указать, на каких из них

драйвер должен производить поиск электронного ключа. Это весьма полезно

для уменьшения времени ответа ключа. Например, если ключ в Вашем компь-

ютере подсоединен к порту LPT2, а к LPT1 подсоединен принтер, то можно

запретить использование порта LPT1 для поиска ключа. По умолчанию поиск

разрешен на всех параллельных портах Вашего компьютера.

Рядом с именем порта отображается его базовый адрес.

Задание способов захвата порта

------------------------------

Захват параллельного порта необходим во избежание конфликтов в

случаях, когда защищенное приложение пытается обратиться к ключу в тот

момент, когда другое приложение использует тот же порт, к которому при-

соединен ключ (например, происходит печать на принтер). Захват порта

драйвером производится только на время общения с ключом, после чего

порт освобождается.

По умолчанию утилита конфигурации устанавливает автоматический

способ захвата. Остальные способы имеет смысл использовать ТОЛЬКО

опытным пользователям, хорошо знакомым с тонкостями работы операционной

системы и переферийных устройств.

Каждому из выбранных параллельных портов вы можете задать свое

сочетание способов захвата.

Установка таймаута

------------------

В случае если параллельный порт, к которому драйвер Guardant

пытается получить доступ, оказывается занятым, драйвер начинает ждать

момента освобождения порта. Время ожидания драйвера называется таймау-

том. В течение этого времени он будет постоянно проверять состояние пор-

та и, если порт так и остался занятым, защищенному приложению будет воз-

вращена ошибка #24 (Port busy).

Значение таймаута в секундах задается в нижней части окна.

Допустимые значения - от 0.001 до 600 секунд. Значение таймаута по умол-

чанию - 10 секунд.

Дополнительные настройки

------------------------

Начиная с версии 3.2 в драйвере Guardant появилась возможность

выбирать метод формирования задержек и используемый таймер. По умолчанию

установлен способ [Автоматически], при котором драйвер самостоятельно

определяет наиболее стабильно работающий таймер и способ задержек.

Снятие автоматического способа и изменение данных настроек НАС-

ТОЯТЕЛЬНО НЕ РЕКОМЕНДУЕТСЯ, т. к. это может привести к нестабильной ра-

боте всей системы, ошибкам обмена с электронным ключем и т.п.

ПРИМЕЧАНИЕ:

Дополнительные настройки вступают в силу ТОЛЬКО после нажатия

кнопки [OK] в ОСНОВНОМ ДИАЛОГЕ конфигурирования.

Если нажать [OK] в дополнительном диалоге и [Отмена] в основном,

то изменения произведены НЕ БУДУТ!

---------------------------------------- ------------------------------

После задания всех нужных параметров нажмите кнопку [Ok] (или

кнопку [Отмена] для отмены изменений). Произойдет выход в главное окно

утилиты.

Во время первого запуска INSTDRV (т.е. когда драйвер Guardant

еще не был загружен) умалчиваемые значения параметров считываются из

файла INSTDRV.INI, находящегося в том же каталоге, что и сама утилита.

Все заданные Вами параметры записываются в системный реестр и

в дальнейшем считываются оттуда как драйвером Guardant, так и утилитой.

После конфигурирования драйвера перезагрузка системы не требует-

ся. Все внесенные Вами изменения вступают в силу сразу после нажатия

кнопки [ОК] в диалоге настройки.

----------------------------

- ПЕРЕУСТАНОВКА ДРАЙВЕРА -

----------------------------

При переустановке драйвера последовательно выполняется два дей-

ствия: УДАЛЕНИЕ и УСТАНОВКА драйвера.

ВНИМАНИЕ! В Windows 95/98 после переустановки необходимо перезагрузить

компьютер, т.к. удаленный драйвер остается активен в памяти

до перезагрузки системы