ГОСТ Р ИСО/МЭК19784-1—2007
8.4.3 Функция BloAPI_Procoss
BioAPLRETURN BioAPI BioAPI_Process
(BioAPI_HANDLE BSPHandle."
const BioAPI_INPUT_B!R ‘CapturedBIR.
const BioAPI_BIR_BIOMETRIC_DATA_FORMAT ‘OutputFormat.
BioAPI_BIR_HANDLE ‘ProcessedBIR)?
8.4.3.1 Описание
Данная функция обрабатывает промежуточные данные, полученные путем вызова функции
BioAPI_Capture, для последующей верификации или идентификации. Если присоединенный вызов
ПБУ позволяет проводить обработку, то ПБУ создает обработанный биометрический образец ЗБИ. В
противном случае ProcessedBIR приравнивается к пустому указателю и функция возвращает
BtoAPIERR_BSP_FUNCTION_NOT_SUPPORTED.
Данная функция приводит к созданию ЗБИ ПБУ. Приложение может восстановить ЗБИ с помощью
дескриптора путем вызова функции BioAPI_GetBIRFromHandle, которая также освобождаетдескриптор
или можетосвободитьпамять,связаннуюсдескриптором ЗБИ путем вызова функции BioAPIFrceBIRHandle.
8.4.3.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
CapturedBIR (входной) — полученная ЗБИ или ее дескриптор.
OutputFormat (входной/необязатвльный) — определяет, какой формат ББД будет использоваться
при возвращении ProcessedBIR, если ПБУ поддерживает более одного формата. Пустой указатель озна
чает. что формат должен быть выбран ПБУ.
ProcessedBIR (выходной) — дескриптор вновь созданной «обработанной» ЗБИ должен быт равен
пустому указателю.
8.4.3.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнении функции. Все остальные значения описывают
типошибки.
8.4.3.4 Ошибки
BioAPIERR_INVALID_BIR_HANDLE
BioAPIERRJNVALID.BIR
BioAPIERR_BIR_SIGNATURE FAILURE
BioAPIERR_TOO_MANY_HANDLES
BioAPIERRJNCONSISTENTPURPOSE
BioAPIERR_PURPOSE_ NOT_SUPPORTED
BioAPIERR_UNSUPPORTED_FORMAT
BioAPIERR_RECORD_NOT_FOUND
Bk>APIERR_FUNCTION_NOT_SUPPORTED
BioAPI ERR_QUALITY_ERROR
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.4.4 Функция BioAPI_ProcessWithAuxBIR
BioAPI_Retum BioAPI BioAPI_ProcessPrematctiData
(BioAPI_HANDLE BSPHandle.
const BioAPI_INPUT_BIR ‘CapturedBIR.
const BioAPI_INPUT_BIR ‘PrematchData.
BioAPI_HANDLE_PTR ProcessedBIR);
8.4.4.1 Описание
Данная функция обрабатывает промежуточные данные, полученные при вызове функции
BioAPI_Capture. всоответствии со вспомогательнымиданными, создавая обработанные биометрические
образцы с целью их последующей верификации или идентификации. Это позволяет разрабатывать прило
жения. требующие в виде входного параметра вспомогательныеданные обработки.
П р и м е ч а н и е — Данная функция может использоваться для поддержки биометрических сопоставле-
ний-ка-карте (СНК). Описание использования БиоАПИ для полной обработки СНК. приведено в приложении С.
раздел С.8.
Если возможность работы со вспомогательными данными поддерживается прикрепленным обраще
нием ПБУ. то ПБУ создает обработанный биометрический образец ЗБИ. иначе, параметр ProcessedBIR
установлен в ноль, и функция возвращает BioAPIERR_BSP_FUNCTION_NOT_SUPPORTED.
44