Condividi tramite

struttura WINBIO_CAPTURE_PARAMETERS (winbio_ioctl.h)

  • Articolo

Il IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL usa la struttura WINBIO_CAPTURE_PARAMETERS come input.

Sintassi

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;

Membri

PayloadSize

Dimensioni totali del payload.

Purpose

Scopo WINBIO_BIR_PURPOSE, che specifica la modalità di utilizzo dei dati acquisiti e, di conseguenza, la modalità di ottimizzazione. Alcuni sensori passeranno in una modalità diversa a seconda del motivo dell'acquisizione dei dati.

L'esempio di codice seguente mostra i possibili valori di maschera di bit per 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

Specifica il formato WINBIO_REGISTERED_FORMAT dei dati da restituire.

VendorFormat

GUID fornitore di WINBIO_UUID facoltativo. Indica il formato preferito dei dati specifici del fornitore nel bir.

Flags

Specifica il livello di elaborazione WINBIO_BIR_DATA_FLAGS e altri attributi per i dati da restituire. Se il proprietario del formato e il tipo sono standard di Windows, deve essere WINBIO_DATA_FLAG_RAW.

L'esempio di codice seguente illustra i possibili valori di maschera di bit per 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'.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile in Windows 7 e versioni successive di Windows.
intestazione winbio_ioctl.h

Vedere anche

IOCTL_BIOMETRIC_CAPTURE_DATA