ГОСТ Р ИСО/МЭК 19784-1-2007 Автоматическая идентификация. Идентификация биометрическая. Биометрический программный интерфейс. Часть 1. Спецификация биометрического программного интерфейса (с Изменением N 1)
7.36 Тип BioAPI_GUI_STATE_CALLBACK (БиоАПИ 2.0)
Данный подраздел применяется только при использовании версии БиоАПИ 2.0.
(Измененная редакция, Изм. N 1).
7.36.1 Данный тип представляет собой указатель на функцию обратного вызова, которую предоставляет приложение для того, чтобы дать возможность ПБУ передавать через инфраструктуру приложению информацию о состоянии графического интерфейса пользователя (ГИП) и получать ответы.
7.36.2 Функция
typedef BioAPI_RETURN (BioAPI *BioAPI_GUI_STATE_CALLBACK) | ||||
(void *GuiStateCallbackCtx, | ||||
BioAPI_GUI_STATE GuiState, | ||||
BioAPI_GUI_RESPONSE *Response, | ||||
BioAPI_GUI_MESSAGE Message, | ||||
BioAPI_GUI_PROGRESS Progress, | ||||
const BioAPI_GUI_BITMAP *SampleBuffer); | ||||
Возврат значения, отличающегося от BioAPI_OK (например, BioAPI_Enroll), приводит к немедленному возврату вызванной функции к вызывающему коду с передачей ему данного значения в качестве кода ошибки.
7.36.3 Параметры
GuiStateCallbackCtx (входной) - указатель на контекстную информацию, предоставленный инициатором запроса и возвращаемый его инициатору.
GuiState (входной) - индикация текущего состояния ПБУ по отношению к ГИП, а также индикация того, какие другие параметры являются доступными.
Response (выходной) - указатель на ответ приложения поставщику биометрической услуги при возврате от обратного вызова.
Message (входной/необязательный) - номер сообщения, подлежащего отображению пользователю. Номера и тексты сообщений не стандартизированы и зависят от ПБУ. GuiState указывает наличие параметра Message; если сообщения не могут быть переданы, параметр имеет нулевое значение.
Progress (входной/необязательный) - значение, которое указывает степень выполнения (в процентах) операции по созданию образца или ЗБИ. Значение может использоваться для отображения индикатора выполнения. Не все ПБУ поддерживают индикацию выполнения. GuiState указывает наличие значения параметра Progress в вызове; если степень выполнения не передается, параметр имеет нулевое значение.
SampleBuffer (входной/необязательный) - текущий буфер образца для приложения, подлежащий отображению. GuiState указывает наличие параметра SampleBuffer; если он не передается, параметр имеет нулевое значение.
Примечание - Описание интерфейса пользователя приведено в приложении С, раздел С.7.