struktur WINBIO_CAPTURE_PARAMETERS (winbio_ioctl.h)

Artikel
02/27/2024

IOCTL IOCTL_BIOMETRIC_CAPTURE_DATA menggunakan struktur WINBIO_CAPTURE_PARAMETERS sebagai input.

Sintaks

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;

Anggota

PayloadSize

Ukuran total payload.

Purpose

Tujuan WINBIO_BIR_PURPOSE, yang menentukan bagaimana data yang diambil akan digunakan, dan sebagai hasilnya, bagaimana data tersebut harus dioptimalkan. Beberapa sensor akan masuk ke mode yang berbeda tergantung pada alasan pengambilan data.

Contoh kode berikut menunjukkan kemungkinan nilai bitmask untuk 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

Menentukan format WINBIO_REGISTERED_FORMAT data yang akan dikembalikan.

VendorFormat

GUID vendor WINBIO_UUID opsional. Ini menunjukkan format yang disukai dari data khusus vendor di BIR.

Flags

Menentukan tingkat pemrosesan WINBIO_BIR_DATA_FLAGS dan atribut lainnya agar data dikembalikan. Jika pemilik dan jenis format adalah standar Windows, ini harus WINBIO_DATA_FLAG_RAW.

Contoh kode berikut menunjukkan kemungkinan nilai bitmask untuk 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'.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Header	winbio_ioctl.h

Lihat juga

IOCTL_BIOMETRIC_CAPTURE_DATA

Bagikan melalui