IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL (winbio_ioctl.h)
IOCTL_BIOMETRIC_GET_SENSOR_STATUS IOCTL 會告知驅動程式執行任何必要的步驟,以收集裝置的目前作業狀態。 廠商提供的WBDI驅動程式必須支援此 IOCTL。
主要程序代碼
輸入緩衝區
無。
輸入緩衝區長度
無。
輸出緩衝區
AssociatedIrp。SystemBuffer 成員指向包含WINBIO_DIAGNOSTICS結構的緩衝區。
輸出緩衝區長度
WINBIO_DIAGNOSTICS 結構的長度。
廠商提供的驅動程式可以選擇性地傳回 DWORD 大小的緩衝區,指定要求之作業所需的緩衝區大小。
狀態區塊
指出 DeviceIoControl 對驅動程式的呼叫是否已完成,而且 OUT 承載是否有效。
Status 成員會設定為下表中的其中一個值。
狀態值 | 描述 |
---|---|
S_OK,STATUS_SUCCESS | 作業已成功完成。 如果傳回的數據大小是 DWORD,承載會包含呼叫所需的緩衝區大小。 否則,承載會包含完整的輸出緩衝區。 |
E_INVALIDARG | 未正確指定參數。 |
E_UNKNOWN | 防止承載填入的任何其他失敗。 |
E_UNEXPECTED | 防止承載填入的任何其他失敗。 |
E_FAIL | 防止承載填入的任何其他失敗。 |
備註
如果廠商提供的驅動程式傳回整個承載,它應該以生物特徵辨識作業的狀態填入WINBIO_DIAGNOSTICS的 WinBioHresult 成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 7 和更新版本的 Windows 中使用。 |
標頭 | winbio_ioctl.h |