ГОСТ Р ИСО/МЭК19784-1—2007
в.6.4.4 Ошибки
BioAPIERR_FUNCTION_NOT_SUPPORTED
BioAPIERR_UNITJNJJSE
BfoAPIERRJNVALb UNIT ID
B(oAPIERR_UNIT NOTJNSERTED
BioAPIERR_CALIBRATlON_NOT_SUCCESSFUL
BtoAPIERR_TIMEOUT_EXPIRED
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.7 Служебные операции
8.7.1 Функция BioAPI_Cancol
BioAPI_RETURN BioAPI BioAPI_Cancel
(BioAPI_HANDLE BSPHandle);
8.7.1.1 Описание
Данная функция должна отменить все заблокированные в данный момент вызовы, связанные с
BSPHandlo. Данная функция не должна завершаться до тех пор. пока все заблокированные вызовы не
будут отменены.
8.7.1.2 Параметры
BSPHandle (входной) — дескриптор присоединенного ПБУ.
8.7.1.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение ВюАР1_ОК указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.7.1.4 Ошибки
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.7.2 Функция BioAPI_Freo
BioAPI_RETURN BioAPI BioAPI_Free
(void* Ptr).
8.7.2.1 Описание
Данная функция освобождает область памяти, на которую указывает параметр Ptr. Если Ptr имеет
нулевое значение, никакие действия не выполняются. В противном случае, если Ptr не соответствует
указателю, ранее возвращенному функциями БиоАПИ. или если область памяти уже была освобождена
вызовом функции BioAPI_Free, последствия вызова данной функции неопределенны.
Также используют функции BroSPI, в которых ПБУ выделяет область памяти, которая допжиа быть
освобождена инфраструктурой путем вызова функции BioSPI_Free. Каждый раз, когда инфраструктура по
сылает блок памяти приложению, оно становится ответственным за освобождениеданного блока памяти. В
таких случаях приложение вызывает функцию BioAPI_Froo и инфраструктура (или получатель вызова)
должна или освободить блок памяти, или вызвать функцию BioSPI_Free прикрепленной сессии соответ
ствующего ПБУ.
П р и м е ч а н и е — Инфраструктура может быть реализована таким образом, что ПБУ распределяет
указатели, которые не передаются приложению. В таком случае инфраструктура перемещает данные, возвра
щенные ПБУ, в выделенную область памяти и после копирования в область памяти до возвращения в приложе ние
вызывает функцию
BioAPI_Free.
Однако такие действия инфраструктуры не сообщаются приложению.
В других случаях инфраструктура сама распределяет память и передает приложению указатель на
нее. В таких случаях, когда приложение вызывает BioAPI_Free, инфраструктура должна освободить об
ласть памяти, не вызывая функцию BioSPI_Free ПБУ.
Необходимо, чтобы инфраструктура сохраняла информацию о том. какие блоки памяти она распреде
лила сама и какие блоки памяти были получены от ПБУ. В дальнейшем онадолжна хранить информацию о
ПБУ и прикрепленных сессиях, в которых инфраструктура получила блок памяти.
8.7.2 2 Параметры
Ptr(входной) — указатель на освобождаемую память.
8.7.2.3 Возвращаемое значение
Значение BioAPI_RETURN указывает науспешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8 7.2.4 Ошибки
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
63