IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)
IOCTL IOCTL_BIOMETRIC_CALIBRATE предписывает драйверу выполнить все необходимые действия для калибровки устройства для использования. На внутреннем сервере драйвер также может собирать и возвращать данные калибровки конкретного поставщика для анализа приложением. Драйверы WBDI, предоставляемые поставщиком, должны поддерживать этот IOCTL.
Основной код
Входной буфер
Нет.
Длина входного буфера
Нет.
Выходной буфер
AssociatedIrp. Элемент SystemBuffer указывает на буфер, содержащий WINBIO_CALIBRATION_INFO структуру.
Длина выходного буфера
Длина структуры WINBIO_CALIBRATION_INFO .
Драйвер, предоставляемый поставщиком, может при необходимости возвращать буфер размера DWORD, указывающий размер буфера, необходимый для запрошенной операции.
Блок состояния
Указывает, выполнен ли вызов DeviceIoControl к драйверу и допустимы ли полезные данные OUT.
Для элемента Status задано одно из значений в следующей таблице.
| Значение состояния | Описание |
|---|---|
| S_OK, STATUS_SUCCESS | Операция выполнена успешно. Если размер возвращаемых данных — DWORD, полезные данные содержат размер буфера, необходимый для вызова. В противном случае полезные данные содержат полный выходной буфер. |
| E_INVALIDARG | Параметры указаны неправильно. |
| E_UNKNOWN | Любой другой сбой, препятствующий заполнению полезных данных. |
| E_UNEXPECTED | Любой другой сбой, препятствующий заполнению полезных данных. |
| E_FAIL | Любой другой сбой, препятствующий заполнению полезных данных. |
Комментарии
Если драйвер, предоставленный поставщиком, передает все полезные данные, он должен заполнить член WinBioHresult WINBIO_CALIBRATION_INFO состоянием биометрической операции.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | winbio_ioctl.h |