ГОСТ Р ИСО/МЭК19784-1—2007
к любым собранным данным, и все локальные операции могут быть выполнены с помощью дескрипторов.
Если приложению необходимо получить данные для их сохранения в базе данных ЗБИ или пересылки на
сервер, оно может извлечь их путем вызова функции BioAPI_GetBIRFromHandle.
По умолчанию за предоставление связанного с получением данных интерфейса пользователя отве
чает ПБУ. Приложение может запросить управление видом и поведением ГИП путем предоставления ука
зателя обратного вызова ГИП в BioAPI_SetGUICallbacks. Дополнительное описание особенностей интер
фейса пользователя приведено в приложении С. раздел С.7.
Использование устройств получения биометрическихданных происходит последовательно. Если два
или более биометрических приложения одновременно запрашивают датчик, «опоздавшие» будут ждать
завершения операции или истечения времени ожидания. Этот порядок установлен во всех функциях полу
чения данных. За сериализацию отвечает ПБУ. В свою очередь ПБУ реализует сериализацию, используя
признак «занято» (BioAPI_UNITJNJJSE) или устанавливая очередность.
Дескриптор ЗБИ. возвращаемый функцией, должен быть освобожден приложением путем вызова
функции BioAPI_FreeBIRHandle, если приложение больше не использует его.
8.4.1.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
Purpose (входной) — значение, указывающее назначение получаемых биометрическихданных.
Subtype (входной/необязательный) — определяет тип полученных данных (например, левый или
правый глаз). Значение BioAPI_NO_SUBTYPE_AVAILABLE (0x00) показывает, что ПБУ должен выбрать
подтип данных.
П р и м е ч а н и е — Не все ПБУ поддерживают получение специфических данных. Действительный подтип
должен быть указан в заголовке возвращаемого CapturedBIR.
OutputFormat(входной/необязательный)— определяет формат ББД. который будет использоваться
при возвращении CapturedBIR в том случае, если ПБУ поддерживает более одного формата. Пустой ука
затель означает, что ПБУ должен выбрать формат.
CapturedBIR (выходной) — дескриптор ЗБИ. содержащей полученныеданные. Эти данные являются
либо ЗБИ «промежуточного» типа(которая можетиспользоваться исключительнофункциями BioAPI Procoss,
BioAPI_CreatoTemplate или BioAPI_ProcessWithAuxData в зависимости от назначения), либо «обрабо
танной» ЗБИ (которая может непосредственно использоваться функциями BioAPI_VerifyMatch или
BioAPlJdentifyMatch в зависимости от назначения).
Timeout (входной) — целое число, определяющее значение времени ожидания (в миллисекундах)
для операции. Если время ожидания истекло, функция возвращает ошибку без предоставления результа
тов операции. Данное значение может быть любым положительным числом. Значение минус 1означает,
что будет использоваться значение времени ожидания, заданное по умолчанию ПБУ.
AudilData (выходной/ необязательный) — дескриптор ЗБИ, содержащей исходные биометричес
кие данные. Эти данные могут использоваться для предоставления биометрических данных личности.
Нулевой указатель на входе указывает, что контрольные данные не будут собраны. Не все ПБУ
поддерживаютсбор контрольных данных.ПБУ может возвратить значение дескриптора
BioAPI_UNSUPPORTED_BIR_HANDLE. чтобы указать, что AuditData не поддерживается, или значение
BioAPI_INVALID_BIR_HANDLE. чтобы указать, что контрольныеданные недоступны.
8.4.1.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.4.1.4 Ошибки
BioAPIERR_USER_CANCELLED
BicAPIERRJJNABLE_TO_CAPTURE
BioAPIERR TOO_MANY HANDLES
BioAPIERR_TI MEOUT_EXPIRED
BioAPIERR_PURPOSE_NOT_SUPPORTED
BioAPIERR UNSUPPORTED FORMAT
BioAPIERR_UNlTJN_USE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.4.2 Функция BioAPI_CreateTemplate
BioAPI RETURNВюАР1 BioAPI_CreateTemplate
(BioAPI_HANDLE BSPHandle.
const BioAPI_INPUT_BIR ‘CapturedBIR.
42