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 |