Compartir a través de


estructura WINBIO_CAPTURE_PARAMETERS (winbio_ioctl.h)

El IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL usa la estructura WINBIO_CAPTURE_PARAMETERS como entrada.

Sintaxis

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;

Miembros

PayloadSize

Tamaño total de la carga.

Purpose

Un WINBIO_BIR_PURPOSE propósito, que especifica cómo se van a usar los datos capturados y, como resultado, cómo se debe optimizar. Algunos sensores entrarán en un modo diferente en función del motivo de la captura de datos.

En el ejemplo de código siguiente se muestran los posibles valores de máscara de bits para 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

Especifica el formato WINBIO_REGISTERED_FORMAT de los datos que se van a devolver.

VendorFormat

Un GUID de proveedor de WINBIO_UUID opcional. Esto indica el formato preferido de los datos específicos del proveedor en el BIR.

Flags

Especifica el WINBIO_BIR_DATA_FLAGS nivel de procesamiento y otros atributos para los datos que se van a devolver. Si el propietario y el tipo de formato son el estándar de Windows, debe ser WINBIO_DATA_FLAG_RAW.

En el ejemplo de código siguiente se muestran los posibles valores de máscara de bits para 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'.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Encabezado winbio_ioctl.h

Consulte también

IOCTL_BIOMETRIC_CAPTURE_DATA