ГОСТ Р ИСО/МЭК19784-1—2007
8.3.1.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.3.1.4 Ошибки
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.3.2 Функция BioAPI_SetGUICallbacks
BioAPI_RETURN BioAPI BioAPI_SetGUICallbacks
(BioAPI_HANDLE BSPHandle,
BioAPI_GUI_STREAMING_CALLBACKGuiStreamingCa!lback.
void *GuiStreamingCallbackCtx.
B»oAPI_GUI_STATE_CALLBACK GuiStateCallback.
void ‘GuiStateCallbackCtx);
8.3.2.1 Описание
Данная функция позволяет приложению устанавливать обратные вызовы так. что приложение может
управлять внешним видом и поведением биометрического интерфейса пользователя, получая от ПБУ пос
ледовательные битовые изображения, называемые потоковыми данными, для их отображения биометри
ческим приложением, а также информацию о режиме.
П р и м е ч а н и е — Не все ПБУ поддерживают функцию предоставления потоковых данных.
8.3.2.2 Параметры
BSPHandle (входной) — дескриптор присоединенного поставщика биометрической услуги.
GuiStreamingCallback (входной) — указатель на обратный вызов приложения для взаимодействия с
представлением потоковых биометрическихданных.
GuiStreamingCallbackCtx (входной) — указатель на контекстную информацию, предоставленную при
ложением. которая будет представлена в обратном вызове.
GuiStateCallback (входной) — указатель на обратный вызов приложения для взаимодействия с изме
нениями состояния ГИП.
GuiStateCallbackCtx (входной) — указатель на контекстную информацию, предоставленную приложе
нием. которая будет представлена в обратном вызове.
П ри м е ч е н и е1 — Определения функциональных подтипов для BioAPI_GUI_STATE_CALLBACK и
BioAPI_GUI_STREAMING_CALLBACK приведены в 7.36 и 7.37 соответственно.
П р и м е ч а н и е 2 — Определение интерфейса пользователя приведено в приложении С. раздел С.7.
8.3.2.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI, ОК указывает на отсутствие ошибки. Все остальные значения описывают условия
ошибки.
8.3.2.4 Ошибки
BioAPIERRJNVALID_POINTER
BioAPIERR_INVAUD_BSP_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.4Биомотрическио функции
8.4.1 Функция BioAPI_Capture
BioAPI, RETURN BioAPI BioAPI_Capture
(BioAPI_HANDLE BSPHandle?
BioAPI_BIR_PURPOSE Purpose.
BioAPI_BIR_SUBTYPE Subtype.
const BioAPI_BIR_BIOMETRIC_DATA_FORMAT ‘OutputFormat.
BioAPI_BIR ..HANDLE ‘CapturedBIR.
int32_t Timeout.
BioAPI_BIR_HANDLE ‘AuditData);
8.4.1.1 Описание
Данная функция получает образцы для указанного назначения. ПБУ возвращает ЗБИ «промежуточ
ного» типа в случае, если после этого необходимо вызывать функцию BioAPI_Process, или «обработан
ную» ЗБИ в противном случае. Назначение записано в заголовке CapturedBIR. Если AuditData является
ненулевым указателем, может быть возвращен ЗБИ «исходного» типа. Функция возвращаетдескрипторы
41