Freigeben über


WINBIO_CAPTURE_PARAMETERS Struktur (winbio_ioctl.h)

Die IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL verwendet die WINBIO_CAPTURE_PARAMETERS Struktur als Eingabe.

Syntax

typedef struct _WINBIO_CAPTURE_PARAMETERS {
  DWORD                    PayloadSize;
  WINBIO_BIR_PURPOSE       Purpose;
  WINBIO_REGISTERED_FORMAT Format;
  WINBIO_UUID              VendorFormat;
  WINBIO_BIR_DATA_FLAGS    Flags;
} WINBIO_CAPTURE_PARAMETERS, *PWINBIO_CAPTURE_PARAMETERS;

Angehörige

PayloadSize

Die Gesamtgröße der Nutzlast.

Purpose

Ein WINBIO_BIR_PURPOSE Zweck, der angibt, wie erfasste Daten verwendet werden sollen, und folglich, wie sie optimiert werden soll. Einige Sensoren werden je nach Grund für die Datenerfassung in einen anderen Modus wechseln.

Das folgende Codebeispiel zeigt die möglichen Bitmaskenwerte für WINBIO_BIR_PURPOSE:

#define WINBIO_NO_PURPOSE_AVAILABLE                     ((WINBIO_BIR_PURPOSE)0x00)
#define WINBIO_PURPOSE_VERIFY                           ((WINBIO_BIR_PURPOSE)0x01)
#define WINBIO_PURPOSE_IDENTIFY                         ((WINBIO_BIR_PURPOSE)0x02)
#define WINBIO_PURPOSE_ENROLL                           ((WINBIO_BIR_PURPOSE)0x04)
#define WINBIO_PURPOSE_ENROLL_FOR_VERIFICATION          ((WINBIO_BIR_PURPOSE)0x08)
#define WINBIO_PURPOSE_ENROLL_FOR_IDENTIFICATION        ((WINBIO_BIR_PURPOSE)0x10)
#define WINBIO_PURPOSE_AUDIT                            ((WINBIO_BIR_PURPOSE)0x80)

Format

Gibt das WINBIO_REGISTERED_FORMAT Format der zurückzugebenden Daten an.

VendorFormat

Eine optionale WINBIO_UUID Anbieter-GUID. Dies gibt das bevorzugte Format der anbieterspezifischen Daten in der BIR an.

Flags

Gibt die WINBIO_BIR_DATA_FLAGS Verarbeitungsebene und andere Attribute für die zurückgegebenen Daten an. Wenn der Formatbesitzer und -typ der Windows-Standard sind, muss dies WINBIO_DATA_FLAG_RAW sein.

Das folgende Codebeispiel zeigt die möglichen Bitmaskenwerte für WINBIO_BIR_DATA_FLAGS:

#define WINBIO_DATA_FLAG_PRIVACY                ((UCHAR)0x02)
#define WINBIO_DATA_FLAG_INTEGRITY              ((UCHAR)0x01)
#define WINBIO_DATA_FLAG_SIGNED                 ((UCHAR)0x04)

#define WINBIO_DATA_FLAG_RAW                    ((UCHAR)0x20)
#define WINBIO_DATA_FLAG_INTERMEDIATE           ((UCHAR)0x40)
#define WINBIO_DATA_FLAG_PROCESSED              ((UCHAR)0x80)

#define WINBIO_DATA_FLAG_OPTION_MASK_PRESENT    ((UCHAR)0x08)   // Always '1'.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows 7 und höheren Versionen von Windows.
Header- winbio_ioctl.h

Siehe auch

IOCTL_BIOMETRIC_CAPTURE_DATA