IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)
IOCTL IOCTL_BIOMETRIC_CAPTURE_DATA направляет водителя на получение следующего сканирования биометрических данных. Этот вызов должен переводить устройство в режим записи. Драйверы WBDI, предоставляемые поставщиком, должны поддерживать IOCTL_BIOMETRIC_CAPTURE_DATA.
Основной код
Входной буфер
Длина входного буфера
Длина структуры 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 |