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