IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

WINBIO_CAPTURE_PARAMETERS

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

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

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

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

Данные конкретного поставщика в структуре WINBIO_BIR могут быть в любом формате, который поставщик хотел бы получить от драйвера. Поставщики могут обрабатывать данные в драйвере WBDI или адаптере подсистемы, но данные должны передаваться в одной структуре.

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

Наименьший допустимый размер выходного буфера — это размер DWORD.

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

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

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

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

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

Комментарии

Только одна коллекция данных IOCTL может находиться в состоянии ожидания в любое время. Если устройство ожидает IOCTL_BIOMETRIC_CAPTURE_DATA, IOCTL_BIOMETRIC_CAPTURE_DATA должны вернуть WINBIO_E_DATA_COLLECTION_IN_PROGRESS.

IOCTL_BIOMETRIC_CAPTURE_DATA — это блокирующий сбор данных IOCTL, который завершается при записи биометрических данных.

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

Возможные значения:

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть	winbio_ioctl.h