IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL （winbio_ioctl.h）
IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL 指示驱动程序检索下一次生物识别数据的扫描。 此调用应将设备置于捕获模式。供应商提供的 WBDI 驱动程序必须支持IOCTL_BIOMETRIC_CAPTURE_DATA。
主要代码
输入缓冲区
输入缓冲区长度
WINBIO_CAPTURE_PARAMETERS 结构的长度。
输出缓冲区
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 |