IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)

IOCTL IOCTL_BIOMETRIC_CALIBRATE предписывает драйверу выполнить все необходимые действия для калибровки устройства для использования. На внутреннем сервере драйвер также может собирать и возвращать данные калибровки конкретного поставщика для анализа приложением. Драйверы WBDI, предоставляемые поставщиком, должны поддерживать этот IOCTL.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Нет.

Длина входного буфера

Нет.

Выходной буфер

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