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