ГОСТ Р ИСО/МЭК19784-1—2007
8.4.8.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
тип ошибки.
8.4.8.4 Ошибки
BioAPIERR_USER_CANCELLED
BioAPIERR_UNABLE_TO_CAPTURE
BioAPIERRJNVALID_BIR_HANDLE
BioAPIERR_BIR_SIGNATURE_FAILURE
BioAPIERR_TOO_MANY_HANDLES
Bk>APIERR TIMEOUT EXPIRED
BioAPIERRJNCONSISTENTPURPOSE
BioAPIERR_UNSUPPORTED_FORMAT
BioAPIERR_RECORD_NOT_FOUND
BioAPIERR_QUALfTY_ERROR
BbAPIERR_UNITJN_USE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.4.9 Функция BioAPlJdentlfy
BioAPI_RETURN BioAPI
BioAPI
Jdentify
(BioAPI_HANDLE
BSPHandle7
BsoAPI_FMR MaxFMRRequested.
B
k
>API_BIR_SUBTYPE Subtype.
const BioAPI_IDENTIFY_POPULATION ‘Population,
uint32_t TotalNumberOfTempiates.
BtoAPIBOOL Binning,
uint32_t MaxNumberOfResults.
uint32_t ‘ NumberOfResults,
BioAPLCANDIDATE “ Candidates.
int32_t Timeout
ВюАР1_BIR_HANDLE ‘AuditData);
8.4.9.1 Описание
Данная функция получает биометрическиеданные от присоединенного устройства (модуля датчика)
и сравнивает их с набором контрольных ЗБИ (Population).
Совокупность, с которой проводится сопоставление, может быть представлена одним издвух спосо
бов.
a) в базе данных ЗБИ. обозначаемой открытым дескриптором базы данных:
b
) во входном параметре в виде массива ЗБИ.
П р и м е ч а н и е — При использовании управляемой БПУ базы данных ЗБИ она должна быть сначала
открыта путем вызова функции BioAPt_DbOpen.
Существует возможность использования массива ЗБИ. который может быть определен в
BioAPNDENTIFY P0PULAT10N_TYPE в структуре BioAPI_IDENTIFY_POPULATION. Если он определен как
BioAPI_PRESET_ARRAY_TYPE (3), то будет использоваться массив ЗБИ, который был предварительно
установлен при вызовефункции BioAPI_PresotkJentifyPopulation. Предварительно установленный массив
ЗБИ будет освобожден ПБУ внутренне при вызове BioAPI_BSPDetach.
Приложениедолжно запросить максимальное значение критерия ОЛС успешного сопоставления.
Функция выполняет действия в следующем порядке:
a) получает образец и обрабатывает его соответствующим образом:
b
)определяет число кандидатов популяции, чья оценка схожести соответствует определенному кри
терию;
c)выделяет областьпамяти, достаточнуюдля размещения массиваэлементов типа BioAPI_CANDIDATE
с числом, равным числу кандидатов, определенных в перечислении Ь):
d) заполняет массив информацией о кандидатах, определенных в перечислении Ь), включая
FMRAchieved каждого кандидата:
e) возвращает адрес массива впараметре Candidates и размер массива в параметре NumberOfResults.
П р и м е ч а н и е — Дополнительная информация относительно использования понятия ОЛС для нор
мализованного оценивания схожести и выбора порога приведена в приложении С. раздел С.4.
52