IOCTL_BIOMETRIC_CALIBRATE IOCTL (winbio_ioctl.h)

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

Никакой.

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

Никакой.

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

AssociatedIrp.SystemBuffer указывает на буфер, содержащий структуру WINBIO_CALIBRATION_INFO.

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

Длина структуры WINBIO_CALIBRATION_INFO.

Предоставленный поставщиком драйвер может при необходимости возвращать буфер размера DWORD, указывающий размер буфера, необходимый для запрошенной операции.

Блок состояния

Указывает, является ли вызов DeviceIoControl завершенным драйвером, а полезные данные OUT допустимы.

Элемент состояния имеет одно из значений в следующей таблице.

Значение состояния	Описание
S_OK, STATUS_SUCCESS	Операция успешно завершена. Если размер возвращаемых данных — DWORD, полезные данные содержат размер буфера, необходимого для вызова. В противном случае полезные данные содержат полный выходной буфер.
E_INVALIDARG	Параметры не были указаны правильно.
E_UNKNOWN	Любой другой сбой, который предотвращает заполнение полезных данных.
E_UNEXPECTED	Любой другой сбой, который предотвращает заполнение полезных данных.
E_FAIL	Любой другой сбой, который предотвращает заполнение полезных данных.

Замечания

Если предоставленный поставщиком драйвер передает всю полезные данные, он должен заполнить WinBioHresult член WINBIO_CALIBRATION_INFO с состоянием биометрических операций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7 и более поздних версиях Windows.
заголовка	winbio_ioctl.h