IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)
IOCTL_BIOMETRIC_CALIBRATE IOCTL 指示驱动程序执行任何必要的步骤来校准设备以供使用。 在内部,驱动程序还可以收集并返回供应商特定的校准数据,供应用程序分析。 供应商提供的 WBDI 驱动程序必须支持此 IOCTL。
主要代码
输入缓冲区
无。
输入缓冲区长度
无。
输出缓冲区
AssociatedIrp。SystemBuffer 成员指向包含 WINBIO_CALIBRATION_INFO 结构的缓冲区。
输出缓冲区长度
WINBIO_CALIBRATION_INFO结构的长度。
供应商提供的驱动程序可以选择返回 DWORD 大小的缓冲区,该缓冲区指定请求的操作所需的缓冲区大小。
状态块
指示对驱动程序的 DeviceIoControl 调用是否已完成,并且 OUT 有效负载是否有效。
Status 成员设置为下表中的值之一。
状态值 | 说明 |
---|---|
S_OK、STATUS_SUCCESS | 操作已成功完成。 如果返回的数据大小为 DWORD,则有效负载包含调用所需的缓冲区大小。 否则,有效负载包含完整的输出缓冲区。 |
E_INVALIDARG | 未正确指定参数。 |
E_UNKNOWN | 阻止填充有效负载的任何其他故障。 |
E_UNEXPECTED | 阻止填充有效负载的任何其他故障。 |
E_FAIL | 阻止填充有效负载的任何其他故障。 |
注解
如果供应商提供的驱动程序传回整个有效负载,则应使用生物识别操作的状态填充 WINBIO_CALIBRATION_INFO 的 WinBioHresult 成员。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 7 和更高版本的 Windows 中可用。 |
标头 | winbio_ioctl.h |