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 |