Document Title Here
AET65 API
Version 1.0
idvation GmbH
Otto-Hesse-Straße 19 / T5
Phone +49 6151 9926567
D-64293 Darmstadt
Fax +49 6151 3689296
www.idvation.com
Page 40 of 84
Page 40 of 84
5.2.2.
ABS_BIR_HEADER
This is the header of the BIR. This type is equivalent to BioAPI's structure BioAPI_BIR_HEADER.
In the typical use the BIR is handled as an opaque data, it is not necessary to know the structure of its
header. However, we document it here for completeness. The values provided below are the standard
values used in BIRs produced by the FM.
Please refer to BioAPI documentation for details.
Note that all members of the ABS_BIR_HEADER are always in little endian byte order. This has two
important impacts:
•
The template has exactly same binary representation, when stored to some storage or database, so
they may be used on all platforms despite byte order the platform uses.
•
When using values of the structure, you must convert the values to the natural byte order of the
platform you use.
typedef struct abs_bir_header {
ABS_DWORD Length;
ABS_BYTE HeaderVersion;
ABS_BYTE Type;
ABS_WORD FormatOwner;
ABS_WORD FormatID;
ABS_CHAR Quality;
ABS_BYTE Purpose;
ABS_DWORD FactorsMask;
} ABS_BIR_HEADER
Description
Length
Length of Opaque Data
HeaderVersion
HeaderVersion = 1
Type
Type = 4 (BioAPI_BIR_DATA_TYPE_PROCESSED)
FormatOwner
FormatOwner = 0x12 (STMicroelectronics)
FormatID
FormatID = 0
Quality
Quality = -2 (BioAPI_QUALITY is not supported)
Purpose
Purpose (BioAPI_PURPOSE_xxxx, ABS_PURPOSE_xxxx).
The corresponding BioAPI and BSAPI constants have the same
values.
FactorsMask
FactorsMask = 0x08 (BioAPI_FACTOR_FINGERPRINT)