ГОСТ Р ИСО/МЭК19784-1—2007
NumberOfElements (выходной) — указатель на число элементов массива, равное числу схем ПБУ в
реестре компонентов.
8.1.10.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.1.10.4 Ошибки
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.1.11 Функция BioAPI_QuoryBFPs
BioAPI_ RETURN BioAPI BtoAPI_QueryBFPs
(const ВюАР1_ииЮ *BSPUuid,
BioAPI_BFP_UST_ELEMENT "BFPList.
uint32_t *NumbeЮfElements);
8.1.11.1 Описание
Данная функция возвращает список ПБФ. которые установлены вданный момент в реестре компо
нентов и поддерживаются ПБУ. идентифицированным УУИД ПБУ. Функция выполняетдействия в следую
щем порядке;
a) определяет число установленных ПБФ, поддерживаемыхданным ПБУ;
b
) выделяет область памяти, достаточную для размещения массива элементов типа
BioAPI_BFP_LIST_ELEMENT с числом элементов ПБФ, определенным в перечислении а):
c) заполняет массив идентификационной информацией (категория и УУИД) о ПБФ. определенных в
перечислении а);
d) возвращает адрес массива в параметре BFPList и число элементов массива в параметре
NumberOfElements.
Примечание — Когда инфраструктура вызываетфункцию ПБУ Bk>SPI_QueryBSPs, ПБУ выделяет память
для данных, которые должны быть возвращены инфраструктуре. В некоторых реализациях архитектуры инфра
структура передает данные приложению точно так же. как их возвращает ПБУ. так как приложение интерпрети
рует адрес так же. как и ПБУ и сможет получить доступ к данным, которые размещены ПБУ по этому адресу. В
других реализациях архитектуры инфраструктура должна переместить все данные, возвращенные ПБУ. во вновь
выделенную область памяти, доступную приложению, и вызвать функцию BtoSPI_Free после копирования каждо го
блока памяти, но перед возвращением вызова Bk)API_OueryBSP. В первом случае, когда приложение вызывает
функцию BioAPI_Free, инфраструктураделает соответствующий вызов BioSPI_Free. Во втором случае вызов функ
ции BioAPl_Free обрабатывается инфраструктурой. Однако различия реализации инфраструктуры приложение
не обнаруживает.
Дополнительная информация о поддерживаемых ПБФ может быть получена путем вызова функции
BioAPI_EnumBFPs и анализом параметра BFPSchemaArray по соответствующим BfpUuids.
Данная функция может быть вызвана только после вызова функции BioAPI_Load для специального
ПБУ и не может быть вызвана после вызова функции BioAPIJJnload для ПБУ.
Область памяти, содержащая массив, должна быть освобождена приложением путем вызова функ
ции BioAPI_Freo (см. 8.7.2) в том случае, если приложение больше не использует элементы массива.
8.1.11.2 Параметры
BSPUuid (входной) — УУИД ПБУ. по которому должна быть возвращена информация о ПБФ.
BFPList (выходной) — указатель на массив элементов типа BioAPI_BF:P_UST_ELEMENT (распреде
ленный ПБУ. см. примечание выше) и буфер, содержащий идентификационную информацию о ПБФ.
NumberOfElements (выходной) — указатель на число элементов массива.
8.1.11.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.1.11.4 Ошибки
BioAPIERR_INVAUD_BSP_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.1.12 Функция BioAPI_ControlUnit
BioAPIRETURN BioAPI BioAPI_ControlUnit
(BioAPI_HANDLE
BSPHandlo7
BioAPI_UNITJD UmtlD.
uint32_tControlCode,
const BioAPI_DATA ‘InputData,
BioAPI_DATA ‘OutputData):
38