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