Edit

Share via


WINBIO_BIR structure

The WINBIO_BIR structure represents a biometric information record (BIR). The information record contains header, data, and signature blocks.

Syntax

typedef struct _WINBIO_BIR {
  WINBIO_BIR_DATA HeaderBlock;
  WINBIO_BIR_DATA StandardDataBlock;
  WINBIO_BIR_DATA VendorDataBlock;
  WINBIO_BIR_DATA SignatureBlock;
} WINBIO_BIR;

Members

HeaderBlock

A WINBIO_BIR_DATA structure that contains the size, in bytes, and offset of the BIR header. The header contains information that describes the contents of the information record.

StandardDataBlock

A WINBIO_BIR_DATA structure that contains the size, in bytes, and offset of processed or unprocessed biometric information created by the Windows Biometric Framework (WBF).

VendorDataBlock

A WINBIO_BIR_DATA structure that contains the size, in bytes, and offset of processed or unprocessed biometric information provided by vendor sensors and software.

SignatureBlock

An optional WINBIO_BIR_DATA structure that contains the size, in bytes, and offset of the digital signature message authentication code (MAC) that can be used to verify the integrity of the BIR. If present, the signature or MAC must cover the header and data blocks.

Remarks

The use of offsets rather than pointers allows for easy serialization of the BIR and for less complicated translation between 32 and 64-bit environments or between user and kernel mode.

The BIR is compatible with the Common Biometric Exchange Format Framework (CBEFF) defined by NIST 6529-A.

If this structure contains a StandardDataBlock value, the Type parameter of the header specified by the HeaderBlock parameter must be set to WINBIO_ANSI_381_FORMAT_TYPE. This is the only standard data format supported by the current version of the Windows Biometric Framework.

Requirements

Requirement Value
Minimum supported client
Windows 7 [desktop apps only]
Minimum supported server
Windows Server 2008 R2 [desktop apps only]
Header
Winbio_types.h (include Winbio.h)

See also

Client Application Structures

WINBIO_BIR_DATA

WINBIO_BIR_HEADER