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