IOCTL_BIOMETRIC_UPDATE_FIRMWARE IOCTL (winbio_ioctl.h)
IOCTL IOCTL_BIOMETRIC_UPDATE_FIRMWARE сообщает драйверу, что необходимо обновить встроенное ПО устройства с помощью заданного образа встроенного ПО. Этот 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 | Любой другой сбой, препятствующий заполнению полезных данных. |
Комментарии
Образ встроенного ПО зависит от каждого поставщика и может содержать как данные встроенного ПО, так и любые дополнительные данные, необходимые драйверу для проверки образа.
Если устройство имеет другой механизм обновления встроенного ПО, драйвер может вернуть E_NOTIMPL для этого IOCTL.
Если драйвер, предоставленный поставщиком, передает все полезные данные, он должен заполнить член WinBioHresult WINBIO_BLANK_PAYLOAD состоянием биометрической операции.
Возможные значения:
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | winbio_ioctl.h |