WINBIO_CAPTURE_PARAMETERS-Struktur (winbio_ioctl.h)

Artikel
03/01/2024

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;

Member

PayloadSize

Die Gesamtgröße der Nutzlast.

Purpose

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

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ückzugebenden 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
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile	winbio_ioctl.h

Weitere Informationen

IOCTL_BIOMETRIC_CAPTURE_DATA

Freigeben über