WINBIO_BDB_ANSI_381_RECORD structure

  • Article

The WINBIO_BDB_ANSI_381_RECORD structure contains information about a single fingerprint or palm sample from an end user. A collection of these structures is included in each WINBIO_BDB_ANSI_381_HEADER structure.

Syntax

typedef struct _WINBIO_BDB_ANSI_381_RECORD {
  ULONG                    BlockLength;
  USHORT                   HorizontalLineLength;
  USHORT                   VerticalLineLength;
  WINBIO_BIOMETRIC_SUBTYPE Position;
  UCHAR                    CountOfViews;
  UCHAR                    ViewNumber;
  UCHAR                    ImageQuality;
  UCHAR                    ImpressionType;
  UCHAR                    Reserved;
} WINBIO_BDB_ANSI_381_RECORD;

Members

BlockLength

Contains the number of bytes in this structure plus the number of bytes of sample image data.

HorizontalLineLength

Specifies the number of pixels in a horizontal line of the sample.

VerticalLineLength

Specifies the number of pixels in a vertical line of the sample.

Position

A WINBIO_BIOMETRIC_SUBTYPE value that specifies the finger or palm used to generate the biometric sample. For more information, see Remarks.

CountOfViews

This must be set to one (1);

ViewNumber

This must be set to one (1);

ImageQuality

Reserved. This must be 254 (0xFE).

ImpressionType

Reserved.

Reserved

Reserved. Must be set to zero (0).

Remarks

The Position member specifies the area of the hand or palm used to make the biometric sample. The Windows Biometric Framework (WBF) currently supports only fingerprint capture and uses the following constants to represent position information.

  • WINBIO_ANSI_381_POS_UNKNOWN
  • WINBIO_ANSI_381_POS_RH_THUMB
  • WINBIO_ANSI_381_POS_RH_INDEX_FINGER
  • WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER
  • WINBIO_ANSI_381_POS_RH_RING_FINGER
  • WINBIO_ANSI_381_POS_RH_LITTLE_FINGER
  • WINBIO_ANSI_381_POS_LH_THUMB
  • WINBIO_ANSI_381_POS_LH_INDEX_FINGER
  • WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER
  • WINBIO_ANSI_381_POS_LH_RING_FINGER
  • WINBIO_ANSI_381_POS_LH_LITTLE_FINGER
  • WINBIO_ANSI_381_POS_RH_FOUR_FINGERS
  • WINBIO_ANSI_381_POS_LH_FOUR_FINGERS
  • WINBIO_ANSI_381_POS_TWO_THUMBS

Important

Do not attempt to validate the value supplied for the Position value. The Windows Biometrics Service will validate the supplied value before passing it through to your implementation. If the value is WINBIO_SUBTYPE_NO_INFORMATION or WINBIO_SUBTYPE_ANY, then validate where appropriate.

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