ГОСТ Р ИСО/МЭК19784-1—2007
8.1.12.1 Описание
Данная функция посылает управляющиеданные от приложения модулю БиоАПИ и получаетобратно
данные состояния или рабочие данные. Содержание параметра ControlCode посылаемых (входных) и
получаемых (выходных)данныхдолжно бытьопределено в спецификации на интерфейсдляданного моду ля
БиоАПИ или связанного ИПФ в том случае, если он присутствует.
Данная функция выделяетобласть памяти,достаточнуюдля размещения выходных данных, которые
должны быть возвращены приложению, заполняет блокданными и записывает в поля Length и Data струк
туры OutputData размер и адрес блока памяти соответственно.
Блок памяти, возвращенный при вызове функции БиоАПИ. должен быть освобожден приложением
путем вызова функции BioAPI_Free (8.7.2).
8.1.12.2 Параметры
BSPHandle (входной) — дескриптор присоединенного ПБУ.
Unitld — ИД модуля БиоАПИ.
ControlCode (входной) — код функции в вызываемом модуле БиоАПИ.
InputData (входной) — указатель на структуру BioAPI-DATA. содержащую адреси длину буфера дан
ных. которые должны быть посланы модулю БиоАПИ всоответствии сданным CoritrolCode.
OutputData (выходной) — указатель на структуру BioAPI-DATA. На выходе она должна содержать
адрес и длину буфера данных, содержащего данные, полученные от модуля БиоАПИ после обработки
функции, указанной в ControlCode. Если функция не выделила область памяти, то адресдолжен быть уста
новлен на пустой указатель, а длина буфера задана равной нулю.
8.1.12.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_ОК указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.1.12.4 Ошибки
B
kj
APIERR_BIOAPI_UNIT_NOT_INSERTED
BwAPIERRJWALIDJJNITJD
BtoAPIERRJJNlT INJJSE
BtoAPIERR_INVAUD_BSP_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.2 Операции над дескриптором данных
8.2.1 Операция BioAPI_FroeBIRHandle
BioAPI_RETURN BioAPI BioAPI .FreeBIRHandle
(BioAPIJHANDLE BSPHandle,’
BioAPI. BIR_HANDLE Handle);
8.2.1.1 Описание
Данная функция освобождает память и ресурсы, связанные с указанным дескриптором ЗБИ. Связан
ная с вызовом данной функции ЗБИ больше не может быть получена по этомудескриптору. При необходи
мости биометрическое приложение может сохранить ЗБИ вбазеданных, управляемой ПБУ. (путем вызова
функции BioAPI_DbStoreBIR) перед вызовом функции BioAPI_FreeBIRHandle. В качестве альтернативы
приложение может вызвать функцию BioAPI_GetBIRFromHandle, которая восстановит ЗБИ и очиститдес
криптор. вместовызова функции BioAPI_FreeBIRHandle.
Данная функция может быть вызвана только после вызова функции BioAPI_BSPAttach и не может
быть вызвана по окончании выполнения функции BioAPI_BSPDetach для дескриптора ПБУ. созданного
при выполнении функции BioAPI_BSPAttach.
8.2.1.2 Параметры
BSPHandle (входной) — дескриптор присоединенного ПБУ.
Handle (входной) — освобождаемый дескриптор ЗБИ.
8.2.1.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.2.1.4 Ошибки
BoAPIERRJNVALID_BIR_HANDLE
BioAPIERRJNVALID_BSP_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
39