README (Интегрированная среда моделирования РДО)

________________________________________ ________________________________

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

________________________________________ ________________________________

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

в библиотеке 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 -

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