WINBIO_CAPTURE_PARAMETERS 结构 (winbio_ioctl.h)

IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL 使用 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

可选的WINBIO_UUID供应商 GUID。 这表示 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