ГОСТ Р ИСО/МЭК19784-1—2007
c) заполняет массив схемами всех модулей БиоАПИ. определенных в перечислении а);
d) возвращает адрес массива в параметре UnitSchemaArray и размер массива в параметре
NumberOfElements.
П р и м е ч а н и е — Когда инфраструктура вызываетфункцию ПБУ BioSPI_OueryUnils. ПБУ выделяет память
для данных, которые должны быть возвращены инфраструктуре. В некоторых реализациях архитектуры инфра
структур» передает данные приложению в точности о том. как возвращено ПБУ. так как приложение интерпрети
рует адрес так же. как и ПБУ. и сможет получить доступ к данным, которые размещены по этому адресу. В других
реапизациях архитектуры инфраструктура должна переместить все данные, возвращенные ПБУ. во вновь выде
ленный блок памяти, доступный приложению, и вызвать функцию BioSPI_Free после копирования каждого блока
памяти, но перед возвращением вызова ВюАРIQueryUnits. В первом случае, когда приложение вызывает функ
цию B>oAPI_Free. инфраструктураделает соответствующий вызов BioSPI_Free. Во втором случав вызов BioAPI_Free
обрабатывается самой инфраструктурой. Однако особенности данных реализаций инфраструктуры не видны
приложению.
Блок памяти, содержащий массив, должен быть освобожден приложением путем вызова функции
BioAPI_Free (см. 8.7.2). если он больше не нужен приложению. Блок памяти, на который ссылаются эле
менты UnitProperties в пределах какого элемента массива, должен также быть освобожден приложением
путем вызова функции BioAPI_Free. если он больше но нужен приложению. Данная функция может быть
вызвана только после вызова функции BioAPI_Load для ПБУ и не может быть вызвана после вызова
функции BioAPlJJnloadдля ПБУ.
8.1.9.2 Параметры
BSPUuid (входной) — УУИД ПБУ. на который должна быть возвращена информация о модуле.
UnitSchemaArray (выходной) — указатель на массив элементов типа BioAPI_UNIT_SCHEMA (распре
деленный ПБУ. см. примечание к 8.1.9.1). содержащий информацию о схемах модуля.
NumberOfElements (выходной) — указатель на число элементов массива.
8.1.9.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.1.9.4 Ошибки
BioAPIERR_BSP_NOT_LOADED
BioAPIERRJNVALID_UUID
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.1.10 Функция BioAPI_EnumBFPs
BioAPI_RETURN BioAPI BioAPI_EnumBFPs
(BioAPI_BFP_SCHEMA“ BFPSchemaArray.
uint32_t ’NumberOfElements);
8.1.10.1 Описание
Данная функция предоставляет информацию обо всех ПБУ. установленных вданное время в реестре
компонентов, и выполняется в следующем порядке:
a) выделяет область памяти, достаточную для размещения массива элементовтипа
BioAPI_BFP_SCHEMA с числом элементов, равным числу установленных ПБУ;
b
) заполняет массив схемами всех установленных ПБУ;
c) возвращает адрес массива в параметре BSPSchemaArray и размер массива в параметре
NumberOfElements.
Данная функция может быть вызвана только в том случае, если был сделан, по крайней мере, один
вызов функции BloAPIJnit, для которого еще не был сделан соответствующий вызов функции
BioAPl_Torminate.
Данная функция обрабатывается в инфраструктуре БиоАПИ и не передается ни одному ПБУ.
Область памяти, содержащая массив, должна быть освобождена приложением с помощью вызова
функции BioAPI_Free (см. 8.7.2) в том случае, если он больше не нужен приложению.
Область памяти, на которую указывают параметры Path и BFPProperty в пределах каждого элемента
массива, также должна быть освобождена приложением путем вызова функции BioAPI_Free. если элемен
ты массива не используются приложением.
8.1.10.2 Параметры
BfpSchemaArray (выходной) — указатель на массив элементов типа BioAPI_UNIT_SCHEMA (распре
деленный инфраструктурой), содержащих информацию о схемах ПБУ
6-
37