共用方式為


IOCTL_BIOMETRIC_RESET IOCTL (winbio_ioctl.h)

IOCTL_BIOMETRIC_RESET IOCTL 會根據目前的電源狀態,將裝置重設為已知或閑置狀態。 廠商提供的WBDI驅動程式必須支援此 IOCTL。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

無。

輸入緩衝區長度

無。

輸出緩衝區

AssociatedIrpSystemBuffer 成員指向包含WINBIO_BLANK_PAYLOAD結構的緩衝區。

輸出緩衝區長度

WINBIO_BLANK_PAYLOAD 結構的長度。

廠商提供的驅動程式可以選擇性地傳回 DWORD 大小的緩衝區,指定要求之作業所需的緩衝區大小。

狀態區塊

指出 DeviceIoControl 對驅動程式的呼叫是否已完成,而且 OUT 承載是否有效。

Status 成員會設定為下表中的其中一個值。

狀態值 描述
S_OK,STATUS_SUCCESS 作業已成功完成。 如果傳回的數據大小是 DWORD,承載會包含呼叫所需的緩衝區大小。 否則,承載會包含完整的輸出緩衝區。
E_INVALIDARG 未正確指定參數。
E_UNKNOWN 防止承載填入的任何其他失敗。
E_UNEXPECTED 防止承載填入的任何其他失敗。
E_FAIL 防止承載填入的任何其他失敗。

備註

如果 iOCTL 擱置中,IOCTL_BIOMETRIC_RESET取消數據收集 IOCTL。 如果有廠商特定的作業進行中,驅動程式應該盡可能取消作業並重設裝置。

如果廠商提供的驅動程式傳回整個承載,它應該填入具有生物特徵辨識作業狀態之 WINBIO_BLANK_PAYLOAD 的 WinBioHresult 成員。

規格需求

需求
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 中使用。
標頭 winbio_ioctl.h