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;
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 |