Compartilhar via

estrutura WINBIO_CAPTURE_PARAMETERS (winbio_ioctl.h)

  • Artigo

O IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL usa a estrutura WINBIO_CAPTURE_PARAMETERS como entrada.

Sintaxe

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;

Membros

PayloadSize

O tamanho total da carga.

Purpose

Uma finalidade WINBIO_BIR_PURPOSE, que especifica como os dados capturados devem ser usados e, como resultado, como eles devem ser otimizados. Alguns sensores entrarão em um modo diferente, dependendo do motivo da captura de dados.

O exemplo de código a seguir mostra os possíveis 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 o formato WINBIO_REGISTERED_FORMAT dos dados a serem retornados.

VendorFormat

Um GUID do fornecedor de WINBIO_UUID opcional. Isso indica o formato preferencial dos dados específicos do fornecedor no BIR.

Flags

Especifica o WINBIO_BIR_DATA_FLAGS nível de processamento e outros atributos para os dados a serem retornados. Se o proprietário e o tipo do formato forem o padrão do Windows, isso deverá ser WINBIO_DATA_FLAG_RAW.

O exemplo de código a seguir mostra os possíveis 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 Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do Windows.
Cabeçalho winbio_ioctl.h

Confira também

IOCTL_BIOMETRIC_CAPTURE_DATA