ГОСТ Р ИСО/МЭК19784-1—2007
7.25 Тип BioAPI_DTG
Данный тип определяет дату и время создания ЗБИ.
typedef struct bioapi_DTG {
BioAPI_DATE Date;
BioAPfTIMETime;
} BioAPI_DTG;
П р и м е ч а н и е — ГДВБиоАПИ в заголовке ЗБИ соответствует CBEFF_creation_date по ИСО I МЭК 19785-1.
7.26 Тип BioAPI_EVENT
Данный перечислимый тип определяет виды событий, которые могут быть вызваны ПБУ, ПБФ или
модулем БиоАПИ. Биометрическое приложение может определять функции обратного вызова обработчика
событий типа BioAPI_EventHandter для получения и управления данными событиями. Функции обратного
вызова регистрируются функцией BioAPI_BSPLoad. Например события, включающие в себя добавление
(подключение) или удаление биометрическогодатчика. События являются асинхронными.
События BioAPI_NOTIFY_SOURCE_PRESEN и BioAPI_NOTIFY_SOURCE_REMOVED формируются
устройством (модулем датчиков), которое способно определить доступен ли пользователь для
предоставлениябиометрическогообразца (например, находится ли палец на сканере).
BioAPI_NOTIFY_SOURCE_PRESENT показывает, что образец доступен, в то время как
BioAPI_NOTIFY_SOURCE_REMOVED показывает, что образец более недоступен. Не требуется, чтобы дан
ные события появлялись парами: несколько событий BioAPi_NOTlFY_SOURCE_PRESENT могут появлять
ся последовательно.
typedef uint32 t BioAPI_EVENT;
#define BioAPI_NOTIFYJNSERT(1)
«define BioAPI_NOTIFY_REMOVE(2)
#define BioAPI_NOTIFY FAULT(3)
«define B*oAPI_NOTIFY„SOURCE_PRESENT(4)
«define BioAPI_NOTIFY_SOURCE_REMOVED(5)
7.27 Тип BioAPI EVENT MASK
Данный тип определяет маску с позициями битов для каждого типа событий. Маска используется для
разрешения и запрещения выдачи уведомлений о событиях и для указания, какие события поддерживают
ся ПБУ.
typedef uint32_t BioAPI_EVENT_MASK;
«define BioAPI_NOTIFYJNSERT BIT
«define BioAPI_NOTIFY_REMOVE_BIT
«define BioAPI_NOTIFY_FAULT_BIT
«define BioAPI_NOTIFY_SOURCE_PRESENT_BIT
«define B
k
>API_NOTIFY_SOURCE_REMOVED_BIT
(0x00000001)
(0x00000002)
(0x00000004)
(0x00000008)
(0x00000010)
П р и м е ч а н и е — Иногда невозможно определить в маске событие подключения, возникающее в
прикрепленной сессии ПБУ. из-за того, что событие может появиться после вызова функции BioAPI_BSPLoad и
перед тем как может быть обработан любой вызов BioAPI_EnableEvents. Данная ситуация возникает из-за того,
что для вызова функции BioAPI_EnableEvents требуется дескриптор, который возвращается функцией
BioAPI_BSPAttach. а вызов функции BioAPI_BSPAttachдолжен следовать за вызовом функции BioAPI_BSPLoad.
Событие подключения (INSERT) возникнет в ПБУ при вызове функции BioAPI_BSPLoad в случае, если модуль
БиоАПИ уже «подключен», и это событие передастся приложению раньше, чем оно сможет вызвать функцию
BioAPI_EnableEvents.
7.28 Тип BioAPI_EventHandlor
7.28.1Данный тип представляет собой интерфейсобработчика событий, который должен поддержи
вать приложение, если необходимо получать асинхронные уведомления о событиях, таких как наличие
биометрического образца или ошибка, обнаруженная ПБУ. Процесс обработки события регистрируется в
инфраструктуре БиоАПИ в ходе выполнения функции BioAPI_BSPLoad. Данный обработчик события пред
назначен для всех общих событий, возникающих в загруженном ПБУ, во всех присоединенных сессиях.
Уведомления об общих событиях обрабатываются через инфраструктуру БиоАПИ.
Функция обработки событий и любые функции, запрашивающие данную функцию (непосредственно
или косвенно), не должны приводить к вызову функций БиоАПИ. Подобные циклические вызовы могут
привести к их взаимной блокировке во многих ситуациях, поэтому обработчик событиядолжен быть реали-
4
’
21