ГОСТ Р ИСО/МЭК 19784-1-2007 Автоматическая идентификация. Идентификация биометрическая. Биометрический программный интерфейс. Часть 1. Спецификация биометрического программного интерфейса (с Изменением N 1)

     8.1.14 Функция BioAPI_Transform (БиоАПИ 2.1)

Данный пункт применяется только при использовании БиоАПИ версии 2.1.

8.1.14.1 Описание

Данная функция трансформирует одну или несколько ЗБИ, предоставленных в качестве входного параметра, в одну или несколько ЗБИ, предоставленных в качестве выходного параметра. Выполняемая трансформация определяется параметром OperationUUID.

Настоящий стандарт не устанавливает никаких стандартных значений для параметра OperationUUID и не устанавливает никаких определенных трансформаций. Предполагается, что значения OperationUUID и их семантика будут установлены либо поставщиком определенного ПБУ, либо в дополнительных спецификациях (таких как сведения о приложении).

Данная функция выполняет действия в следующем порядке:

a) выполняет трансформацию, определенную параметром OperationUUID, используя ЗБИ, предоставленные в качестве входного параметра, и создавая одну или несколько выходных ЗБИ, как требуется для определенной трансформации;

b) выделяет область памяти, достаточную для размещения массива элементов типа BioAPI_BIR_HANDLE с числом элементов, равным числу созданных выходных ЗБИ в перечислении а);

c) заполняет массив информацией о дескрипторах ЗБИ, созданных в качестве выходного параметра в перечислении а); и

d) возвращает адрес массива в параметре OutputBIRs и размер массива в параметре NumberOfOutputBIRs.

Область памяти, возвращаемая вызовом функции БиоАПИ, должна быть освобождена приложением с помощью функции BioAPI_Free (см. 8.7.2), а все существующие в массиве OutputBIRs дескрипторы ЗБИ должны быть удалены путем вызова функции BioAPI_FreeBIRHandle.

8.1.14.2 Параметры

BSPHandle (входной) - дескриптор присоединенного ПБУ.

OperationUUID (входной) - УУИД, определяющий трансформацию, выполняемую ПБУ.

InputBIRs (входной) - массив ЗБИ (содержащий одну или несколько ЗБИ), предоставленных в качестве входного параметра трансформации.

NumberOflnputBIRs (входной) - число ЗБИ в массиве InputBIRs.

OutputBIRs (выходной) - указатель на адрес массива, состоящий из элементов типа BioAPI_BIR_HANDLE и содержащий дескрипторы выходных ЗБИ, созданные трансформацией.

NumberOfOutputBIRs (выходной) - указатель на число элементов массива OutputBIRs.                 

8.1.14.3 Возвращаемое значение

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_ОK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.     

8.1.14.4 Ошибки

BioAPIERR_BIOAPI_UNIT_NOT_INSERTED

BioAPIERR_UNIT_IN_USE

BioAPIERR_TRANSFORMATION_NOT_SUPPORTED