IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL 指示驱动程序检索生物识别数据的下一次扫描。此调用应将设备置于捕获模式。供应商提供的 WBDI 驱动程序必须支持IOCTL_BIOMETRIC_CAPTURE_DATA。

AssociatedIrp。SystemBuffer 成员指向包含WINBIO_CAPTURE_DATA结构的缓冲区。

WINBIO_BIR结构中特定于供应商的数据可以采用供应商想要从驱动程序收集的任何格式。供应商可以选择在 WBDI 驱动程序或引擎适配器中处理数据，但数据必须在一个结构中传递。

最小有效输出缓冲区大小是 DWORD 的大小。

如果驱动程序收到 DWORD 大小的输出缓冲区，则驱动程序必须立即返回完成操作所需的缓冲区大小。不要等待轻扫发生以发送所需的缓冲区大小。

指示对驱动程序的 DeviceIoControl 调用已完成且 OUT 有效负载是否有效。

Status 成员设置为下表中的值之一。

状态值	说明
S_OK、STATUS_SUCCESS	操作已成功完成。如果返回的数据大小为 DWORD，则有效负载包含调用所需的缓冲区大小。否则，有效负载包含完整的输出缓冲区。
E_INVALIDARG	未正确指定参数。
WINBIO_E_DATA_COLLECTION_IN_PROGRESS	设备具有挂起IOCTL_BIOMETRIC_CAPTURE_DATA。
E_UNKNOWN	阻止有效负载填充的任何其他故障。
E_UNEXPECTED	阻止有效负载填充的任何其他故障。
E_FAIL	阻止有效负载填充的任何其他故障。

注解

任何时候只能挂起一个数据收集 IOCTL。如果设备IOCTL_BIOMETRIC_CAPTURE_DATA挂起，IOCTL_BIOMETRIC_CAPTURE_DATA必须返回WINBIO_E_DATA_COLLECTION_IN_PROGRESS。

IOCTL_BIOMETRIC_CAPTURE_DATA是一个阻止的数据收集 IOCTL，在生物识别数据捕获发生时完成。

如果供应商提供的驱动程序传回整个有效负载，则应使用生物识别操作的状态填充 WINBIO_CAPTURE_DATA 的 WinBioHresult 成员。

可能的值包括：

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