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 |