IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL (winbio_ioctl.h)
IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL 會告訴驅動程式使用指定的韌體映射來更新裝置的韌體。 此 IOCTL 是選擇性的。
主要程序代碼
輸入緩衝區
輸入緩衝區長度
WINBIO_UPDATE_FIRMWARE 結構的長度。
輸出緩衝區
AssociatedIrp.SystemBuffer 成員指向包含 WINBIO_BLANK_PAYLOAD 結構的緩衝區。
輸出緩衝區長度
最小的有效輸出緩衝區大小是 DWORD 的大小。 如果驅動程式收到 DWORD 大小的輸出緩衝區,驅動程式應該會傳回要求作業所需的緩衝區大小。
狀態區塊
指出對驅動程式的 DeviceIoControl 呼叫是否已完成,且 OUT 承載有效。
Status 成員會設定為下表中的其中一個值。
狀態值 | 描述 |
---|---|
S_OK、STATUS_SUCCESS | 作業已順利完成。 如果傳回的數據大小是 DWORD,承載會包含呼叫所需的緩衝區大小。 否則,承載會包含完整的輸出緩衝區。 |
E_INVALIDARG | 未正確指定參數。 |
E_UNKNOWN | 任何其他導致承載無法填入的失敗。 |
E_UNEXPECTED | 任何其他導致承載無法填入的失敗。 |
E_FAIL | 任何其他導致承載無法填入的失敗。 |
言論
韌體映像專屬於每個廠商,而且可能包含驅動程序驗證映像所需的韌體數據和任何額外數據。
如果裝置有不同的韌體更新機制,驅動程式可以傳回此 IOCTL 的E_NOTIMPL。
如果廠商提供的驅動程式傳回整個承載,它應該填入WINBIO_BLANK_PAYLOAD的 WinBioHresult 成員,並填入生物特徵辨識作業的狀態。
可能的值包括:
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
標頭 | winbio_ioctl.h |