структура WINBIO_CAPTURE_PARAMETERS (winbio_ioctl.h)

Статья
02/27/2024

IOCTL IOCTL_BIOMETRIC_CAPTURE_DATA использует в качестве входных данных структуру WINBIO_CAPTURE_PARAMETERS.

Синтаксис

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;

Члены

PayloadSize

Общий размер полезных данных.

Purpose

Цель WINBIO_BIR_PURPOSE, которая указывает, как будут использоваться захваченные данные и, как результат, как их следует оптимизировать. Некоторые датчики переходят в другой режим в зависимости от причины записи данных.

В следующем примере кода показаны возможные значения битовой маски для 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

Задает WINBIO_REGISTERED_FORMAT формат возвращаемых данных.

VendorFormat

Необязательный идентификатор GUID поставщика WINBIO_UUID. Это указывает на предпочтительный формат данных конкретного поставщика в BIR.

Flags

Задает WINBIO_BIR_DATA_FLAGS уровень обработки и другие атрибуты возвращаемых данных. Если владелец и тип формата являются стандартом Windows, это должно быть WINBIO_DATA_FLAG_RAW.

В следующем примере кода показаны возможные значения битовой маски для 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'.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть	winbio_ioctl.h

См. также раздел

IOCTL_BIOMETRIC_CAPTURE_DATA

Поделиться через