ГОСТ Р ИСО/МЭК19784-1—2007
По умолчанию за предоставление связанного с операцией идентификации интерфейса пользователя
отвечает ПБУ. Приложение может запросить управление видом и поведением ГИП в виде предоставления
указателя обратного вызова ГИП вфункции BioAPI_SotGUICallbacks. Дополнительное описание особенно
стей интерфейса пользователя приведено в приложении С, раздел С.7.
Так как функция BioAPlJdentify включает в себя функцию получения данных, ома упорядочивает
использование устройств получения биометрическихданных. Если два или более биометрических прило
жения одновременно запрашивают устройства регистрации биометрических данных, «опоздавшие» дол
жны будут ждать завершения операции или истечения времени ожидания. Сериализацию осуществ
ляет ПБУ. Это же может быть реализовано либо возвращением ошибки «занято» (BioAPI_UNIT_IN_USE).
либо организацией очередности.
Область памяти, возвращаемая вызовом функции БиоАПИ. должна быть освобождена приложением
с помощью вызова функции BioAPI_Free в том случае, если приложение больше не будет ее использо
вать (см. 8.7.2). Выходные ЗБИ могутбытьвосстановлены путем вызова функции BioAPI_GetBIRFromHandle,
которая освобождаетдескриптор, или дескриптор может быть освобожден без восстановления ЗБИ путем
вызова функции BioAPI_FreeBIRHandle.
8.4.Э.2 Параметры
BSPHandle (входной) — дескриптор присоединенного ПБУ.
MaxFMRRequosted(входной)— значение ОЛС. являющееся критерием успешной идентификации (по
рог сопоставления).
Subtype (входной/необязательный) — определяет подтип регистрации (например,левый или правый
глаз). Значение BioAPI_NO_SUBTYPE_AVA!LABLE (0x00) указывает, что подтип должен выбрать ПБУ.
П р и м е ч а н и е — Не все ПБУ поддерживают получение данных определенного подтипа.
Population (входной) — совокупность контрольных ЗБИ (шаблонов), по которой проводится идентифи
кация (с помощью ПБУ).
TotalNumberOfTemplates (входной) — определяет общее число шаблонов, сохраненной приложением
совокупности. Нулевое значение указывает, что приложение не предоставляет число шаблонов.
П р и м е ч а н и е — Если совокупность распределена по нескольким базам данных / частям, то общий
размер совокупности будет больше совокупности, которую видит ПБУ. ПБУ гложет отображать FARRequested на
свой внутренний порог сопоставления, основываясь на этом общем размере совокупности.
Binning (входной) — Булево значение, указывающее, включен или нет режим категоризации.
П р и м е ч а н и е 1 — Категоризация — методика оптимизации поиска, которую гложет использовать ПБУ.
Данная методика основана на поиске подмножества совокупности по внутренним характеристикам биометри
ческих данных. Наряду с увеличением скорости операции сопоставления, может также увеличиться вероятность
пропуска кандидата из-за возможности ошибочной буферизации и в результате буфер не будет содержать соот
ветствующуюЗБИ.
П р и м е н а н и в 2 — Дополнительная информация относительно категоризации приведена в приложе
нии А, подпункт А.4.6.2.10.
MaxNumberOfResults (входной) — определяет максимальное число кандидатов, возвращаемых в ре
зультате сопоставления 1:N. Нулевое значение указывает на необходимость возврата всех кандидатов.
NumberOfRosults (выходной) — указатель на число кандидатов, возвращенных в массиве Candidates
в качестве результата сопоставления 1:N.
Candidates (выходной) — указатель на адрес массива элементов типа BioAPI_CANDIDATE, содер
жащих информацию о ЗБИ. идентифицированных в результате процесса сопоставления (то есть индек
сы. связанные с ЗБИ. для которых был превышен порог сопоставления). Данный перечень является
ранжированным, причем запись с самой высокой оценкой схожести находится на первом месте. Если ни
одного кандидата не найдено, данный указатель будет пустым. Если Population была представлена в базе
данных ЗБИ. т. е. значение BioAPIJDENTIFY_POPULATION_TYPE равно BioAPI_DB_TYPE, то мас сив
Candidates содержит указатели на УУИД, связанные с ЗБИ. хранящимися во внутренней базе данных
регистрации ПБУ. Если Population была представлена как передаваемый массив ЗБИ, то
BioAPIJDENTIFY_POPULATlON_TYPE имеет значение Bk>API_ARRAY_TYPE и массив Candidates содер
жит указатели на относительные индексы в передаваемом массиве.
Timeout (входной) — целое число, определяющее значение времени ожидания (в миллисекундах)
для выполнения операции. Если время ожидания истекло, функция возвращает ошибку, память для масси
ва не выделяется и возвращается пустой указатель в параметре Candidates. Данное значение может быть
8
*
53