ГОСТ Р ИСО/МЭК19784-1—2007
8.4.7.1 Описание
Данная функция получает биометрические данные от присоединенного устройства (моду
ля датчика) для создания ProcessedBIR с целью создания BioAPI_PURPOSE_ENROLL,
&oAPI_PURPOSE_ENROLL_FOR VERIFICATION_ONLYили B*oAPI_PURPOSE_ENROLL_FOR_IDENTIFICA-
TION ONLY (то естьдля создания контрольного шаблона).
Необязательный входной параметр ReferenceTemplate используется при создании нового шаблона
NewTemplate. если ПБУ поддерживает возможность обновления шаблона. При этом использование вход
ного шаблона RoferenceTomptate ПБУдля создания выходного шаблона NewTemplate необязательно.
Если ПБУ поддерживает внутреннюю (или управляемую ПБУ) базу данных ЗБИ (например, смарт-
карту или механизм идентификации), то он может дополнительно возвратить УУИД. присвоенный вновь
созданному ReferenceTemplate {контрольному шаблону), сохраненному в базе данных ЗБИ, управляе
мой ПБУ. Значение УУИД должно быть таким же. как и значение, включенное в заголовок ЗБИ, если оно
там присутствует.
По умолчанию за предоставление связанного с операцией регистрации интерфейса пользователя
отвечает ПБУ. Приложение может запросить управление видом и поведением ГИП в виде предоставления
указателя обратного вызова ГИП в BioAPI_SetGUICallbacks. Дополнительное описание особенностей ин
терфейса пользователя приведено в приложении С. раздел С.7.
Так как функция BioAPI_Enroll включает в себя функцию получения данных, она упорядочивает
использование устройства получения биометрическихданных. Еслидва или более биометрических прило
жения одновременно запрашивают датчик, «опоздавшие» должны будут ждать завершения операции или
истечения времени ожидания. Этот порядок установлен во всех функциях получения данных. Сериализа
цию осуществляет ПБУ. Это может быть реализовано либо возвращением ошибки «занято»
(BioAPI_UNIT_IN_USE), либо организациейочередности.
Область памяти, возвращаемая вызовом функции БиоАПИ. должна быть освобождена приложением
путем вызова функции BioAPI_Free, если приложение больше не будет ее использовать (см. 8.7.2). Вы
ходные ЗБИ могут быть восстановлены путем вызова функции BioAPI_CetBIRFromHandle, которая осво
бождает дескриптор, или дескриптор может быть освобожден без восстановления ЗБИ путем вызова
функции BioAPI_FreeBIRHandle.
8.4.7.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
Purpose (входной) — значение,указывающее желаемый подтип получаемых данных
(BioAPI PURPOSE_ENROLL,BioAPI_PURPOSE_ENROLL FOR VERIFICATION_ONLYили
BwAPI_PURPOSE_ENROLL_FORJDENTIFICATION ONLY).
Subtypo (входной/необязательный) — определяет подтип регистрации (например, левый или правый
глаз). Значение BioAPI_NO_SUBTYPE_AVAILABLE (0x00) указывает, что подтип должен выбрать ПБУ.
П р и м е ч а н и е — Не все ПБУ поддерживают получение данных определенного подтипа. Используемый
подтип получения данных будет отображен в заголовке возвращаемого параметра NewTemplate.
OutputFormat (входной/необязательный) — определяет формат ББД возвращаемого NewTemplate.
если ПБУ поддерживает более одного формата. Пустой указатель означает, что ПБУ должен выбрать
формат.
ReferenceTemplate (входной/необязательный) — адаптируемая (обновляемая) ЗБИ. ее ключ в базе
данных или ее дескриптор.
NewTemplate (выходной) — реекриптор вновь созданного шаблона, который получен из новых исход
ных образцов и (необязательно) из ReferenceTemplate.
Payload (входной/необязательный) — указатель на данные, которые будут сохранены ПБУ. Данный
параметр игнорируется, если указатель пустой.
П р и м е ч а н и е 1— Не все ПБУ поддерживают хранение полезной информации.
П р и м е ч а н и е 2 — Дополнительная информация о полезной информации, приведена в приложении А.
подпункт А.4.6.2.6, и приложении С. раздел С.5.
Timoout (входной) — целое число, определяющее значение времени ожидания (в миллисекундах)
для операции. Если время ожидания истекло, функция возвращает ошибку без результатов операции. Дан
ное значение может быть любым положительным числом. Значение минус 1означает, что будет использо
ваться значение времени ожидания, заданное ПБУ по умолчанию.
AudilData (выходной/необязатвлы<ый)— дескриптор ЗБИ, содержащей контрольные биометричес
кие данные, которые могут использоваться для предоставления биометрических данных личности. Нуле-
49