AS ISO IEC 19784.2:2010 pdf – lnformation technology-Biometricapplication programming interface Part 2: Biometric archive function provider interface.
— Bi0AFPI_BAFPLoad:
— BI0AFPIBAFPUnI0ad:
Bi0AFPI_UnitAttach;
– BioAFPI_tjnitDetach;
— Bi0AFPI_QueryUrios;
BI0AFPI Free (the relation of this function to the respective SPI call depends on the behaviour of the BSP – when the BSP copies the data the BFP has allocated memory lm then It can simediately send BioAFPI_Free to the BFP. otherwise the BSP will call this function when itself is requested to free the memory for these data)
Unit management functions:
— Bi0AFPI_ControlUnil (tts function is directly related to the SPI function):
— BioAFPI_Cancel (this function can be called In relation to the respective calls of the SPI or the application, but can be called for other reasons from the BSP also when there is no respective request from the BioAPI framework or application:
— BioAFPI_SetPowecMode (ttss function is directly related to the SPI function).
— Database management functions. These functions are directly related to the respective functions of the
SPI:
— Bi0AFPI_ObOpen;
— BioAFPI_DbClose;
– BIoAFPI_DbCreate.
Bi0AFPI_DbDelete
Record management functions. These functions are directly related to the respective tunctions of the SPI:
BioAFPI_DbSetMarker.
Bi0AFPI_DbFreeMarker.
Data management functions. These functions are directly related to the respective functions of the SPI:
— BIoAFPI_DbStoreBIR:
— Bi0AFPIDbGIBIR:
BIoAFPI_DbGetNextBlR:
BIoAFPI_DbOueryBlR:
— BIoAFPI_DbDeleteBlR.
5.2.5 BI0AFPI_QueryUnhts
BioAP I RETURN BiaAP I eioAFPI_Qu.ryunits
Description
This function returns an array of BioAPl Unit sct’iemas (see 7.55 01 ISGIEC 19784’1:2006). which are managed by the given BAFP and are currently in the inserted state.
1IOTE When the BSP cans the function BIoAFPI OueryUnif S 01 aBFP, the BFP alocales memory tot the data tO be returned to the BSP, In some mipletnentafion architectures, the BSP will sirry pass to the framework the data and the addresses exactly as returned by the BFP because the framework will interpret the addresses wi the same way as the BFP and wil be ie to access Ste data (hat the BFP has placed al those et&ess.s. In other inletnenIati0n architectures, Ste BSP will need to move al the data returned by the BFP to newly allocated memory blocks accessible to the framework. and will cal BI0AFPLF.we after copying each memory block bet before retwning from the BJOSPIQueryUnIts call. In the former caes, when the tramework calls 81oSPI Free, the DSP will mete a corresponding cal to BIoAFPI Free, In the latter case, the calls to 8IDSP V_Free will be handled internally by the DSP However, such dilterences in the behavior of the DSP are not visible to (tie Framework
The memory block containing the array shall be tread by the DSP via a call to BIoA F’Pl_Fr.. when it is no longer needed by the BSP. The memory block pointed to by the UrxtProperty member within each element of the array shall also be treed by the BSP via a call to BI0AFPI_Free when it is no longer needed by the BSP
This function shall only be called alter BIOA FPI Load has been called for the specified BFP, and shall not be called alter 8104 F’PI,,,UnIo.erl has been called for the BFP.
There is no requirement that a unit ID. returned by this function for a given Bi0API unit, be made available with the same unit ID value by the DSP to the framework. A DSP is tree to translate any unit ID value (provided by a BFPI into a different urwi ID value before providing ii to the framework. The purpose of such a translation would be to avoid the existence of duplicate unit IDs within the scope of the BSP, which might happen when a BSP is using two or more BFPs of the same category, or when a DSP is using an archive BFP while also crec1fy managing archive units.
Parameters
BaipiJtEd (input) — The unique identifier for the BAFP for wfich the information is to be returned.
UrstSchema.4rray (output) – A pointer to an address of the array of elements of type Bi0APLUNIT_SCHEMA (alocated by the BSP – but see note above) containing the unit schema information.
Nunibe OIEIernents (oitput) – A pointer to the number of elements in the array, which are managed by the given BAFP and are currently in the inserted slate.
Return Value
A BioA.PI RETURN value indicating success or specifying a particular error condition. The value Ba0API OK indicates success. All other values represent an error condition,
Errors
BioAPI ERRJNVALID_UUID
BioAP I ERRJ4ERY_ERROR.