通过

WINBIO_CAPTURE_DATA结构（winbio_ioctl.h）

  • 项目

IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL 将WINBIO_CAPTURE_DATA结构作为输出返回。

语法

typedef struct _WINBIO_CAPTURE_DATA {
  DWORD                PayloadSize;
  HRESULT              WinBioHresult;
  WINBIO_SENSOR_STATUS SensorStatus;
  WINBIO_REJECT_DETAIL RejectDetail;
  WINBIO_DATA          CaptureData;
} WINBIO_CAPTURE_DATA, *PWINBIO_CAPTURE_DATA;

成员

PayloadSize

有效负载的总大小。 这包括固定长度结构和末尾的任何变量数据。

WinBioHresult

I/O作的状态详细信息。 这是将传递 WINBIO 错误和信息代码的位置。 下表显示了此成员的可能值。

状态值 描述
S_OK 作已成功完成。
WINBIO_E_DATA_COLLECTION_IN_PROGRESS 已经有一个数据收集 IOCTL 挂起。
WINBIO_E_UNSUPPORTED_DATA_FORMAT 此驱动程序和设备不支持指定的格式。
WINBIO_E_UNSUPPORTED_DATA_TYPE 此驱动程序和设备不支持请求的数据类型。
WINBIO_E_INVALID_DEVICE_STATE 无法将设备置于生物识别捕获模式。 这可能是因为设备处于另一种非数据收集模式。
HRESULT_FROM_NT（STATUS_IO_DEVICE_ERROR） 由于设备错误，作未完成。
WINBIO_E_DEVICE_BUSY 设备处于特定于供应商的作的中间。
WINBIO_E_CANCELED 作已由调用方或IOCTL_BIOMETRIC_RESET请求取消。
WINBIO_E_UNSUPPORTED_PURPOSE 驱动程序不支持指定的捕获目的。

SensorStatus

捕获发生后传感器的WINBIO_SENSOR_STATUS状态。 它指定传感器的运行状态。

随时可以查询WINBIO_SENSOR_STATUS。 捕获 I/O 完成后返回WINBIO_SENSOR_STATUS时，它指示捕获是否成功。 下表显示了可能的值。

传感器状态代码 描述
WINBIO_SENSOR_ACCEPT 传感器刚刚成功完成捕获作。 这应仅在捕获作后立即返回。 然后，传感器将返回到WINBIO_SENSOR_READY或WINBIO_SENSOR_BUSY。
WINBIO_SENSOR_REJECT 传感器拒绝了以前的捕获作。 这应仅在捕获作后立即返回。 然后，传感器将返回到WINBIO_SENSOR_READY或WINBIO_SENSOR_BUSY。
WINBIO_SENSOR_READY 传感器已准备好捕获数据。 如果有挂起的数据捕获 IOCTL，传感器已准备好接受数据。
WINBIO_SENSOR_BUSY 传感器正忙或处于无法捕获数据的状态。 例如，设备在打开后仍可能正在初始化。
WINBIO_SENSOR_NOT_CALIBRATED 必须先校准传感器，然后才能将其放入数据收集模式。
WINBIO_SENSOR_FAILURE 传感器设备失败。

RejectDetail

如果传感器状态WINBIO_SENSOR_REJECT，则此成员包含WINBIO_REJECT_DETAIL值。 WINBIO_SENSOR_REJECT指定生物识别采样作失败的原因。

为 Windows 7 定义的重要 值仅适用于指纹拒绝详细信息。
 
WINBIO_TYPE_FINGERPRINT失败详细信息值包括：
#define WINBIO_FP_TOO_HIGH          ((WINBIO_REJECT_DETAIL)1)
#define WINBIO_FP_TOO_LOW           ((WINBIO_REJECT_DETAIL)2)
#define WINBIO_FP_TOO_LEFT          ((WINBIO_REJECT_DETAIL)3)
#define WINBIO_FP_TOO_RIGHT         ((WINBIO_REJECT_DETAIL)4)
#define WINBIO_FP_TOO_FAST          ((WINBIO_REJECT_DETAIL)5)
#define WINBIO_FP_TOO_SLOW          ((WINBIO_REJECT_DETAIL)6)
#define WINBIO_FP_POOR_QUALITY      ((WINBIO_REJECT_DETAIL)7)
#define WINBIO_FP_TOO_SKEWED        ((WINBIO_REJECT_DETAIL)8)
#define WINBIO_FP_TOO_SHORT         ((WINBIO_REJECT_DETAIL)9)
#define WINBIO_FP_MERGE_FAILURE     ((WINBIO_REJECT_DETAIL)10)

CaptureData

类型 WINBIO_DATA 的结构，包含设备捕获的数据，其格式为指定。 WINBIO_DATA结构的 数据 数组成员应包含 WINBIO_BIR 结构。

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows 中可用。
标头 winbio_ioctl.h

另请参阅

IOCTL_BIOMETRIC_CAPTURE_DATA