структура WINBIO_SENSOR_ATTRIBUTES (winbio_ioctl.h)
Структура IOCTL_BIOMETRIC_GET_ATTRIBUTES возвращает структуру WINBIO_SENSOR_ATTRIBUTES в качестве выходных данных.
Синтаксис
typedef struct _WINBIO_SENSOR_ATTRIBUTES {
DWORD PayloadSize;
HRESULT WinBioHresult;
WINBIO_VERSION WinBioVersion;
WINBIO_BIOMETRIC_TYPE SensorType;
WINBIO_BIOMETRIC_SENSOR_SUBTYPE SensorSubType;
WINBIO_CAPABILITIES Capabilities;
WINBIO_STRING ManufacturerName;
WINBIO_STRING ModelName;
WINBIO_STRING SerialNumber;
WINBIO_VERSION FirmwareVersion;
DWORD SupportedFormatEntries;
WINBIO_REGISTERED_FORMAT SupportedFormat[1];
} WINBIO_SENSOR_ATTRIBUTES, *PWINBIO_SENSOR_ATTRIBUTES;
Члены
PayloadSize
Значение DWORD, указывающее общий размер полезных данных, включая структуру фиксированной длины и любые переменные данные в конце.
WinBioHresult
Значение HRESULT, указывающее, что содержит сведения о состоянии операции ввода-вывода. В следующей таблице приведены возможные значения.
| Значение состояния | Описание |
|---|---|
| S_OK | Операция выполнена успешно. |
| HRESULT_FROM_NT(STATUS_IO_DEVICE_ERROR) | Драйверу не удалось собрать необходимые сведения с устройства. |
WinBioVersion
Структура типа WINBIO_VERSION , содержащая версию WinBio WBDI, поддерживаемую драйвером. Чтобы обеспечить совместимость со службой WinBio, WinBioVersion должна содержать ту же основную версию, что и текущая основная версия службы WinBio, в дополнение к дополнительной версии, которая меньше или равна текущей дополнительной версии службы WinBio.
SensorType
Битовая маска DWORD типа WINBIO_BIOMETRIC_TYPE, содержащая биометрические данные, собранные датчиком. В Windows 7 поддерживаются только WINBIO_TYPE_FINGERPRINT.
SensorSubType
Подтип WINBIO_BIOMETRIC_SENSOR_SUBTYPE, содержащий дополнительные сведения о датчике. Например, этот элемент может указать, требуется ли датчику просто коснуться датчика или провести пальцем по датчику.
WINBIO_BIOMETRIC_SENSOR_SUBTYPE могут содержать значения из следующей таблицы.
| Значение биометрического подтипа | Описание |
|---|---|
| WINBIO_FP_SENSOR_SUBTYPE_SWIPE | Устройство требует, чтобы пользователь провести пальцем по датчику. |
| WINBIO_FP_SENSOR_SUBTYPE_TOUCH | Устройство требует, чтобы пользователь размещал весь отпечаток пальца на панели датчика. |
Capabilities
Подтип WINBIO_CAPABILITIES, который указывает, какие возможности поддерживаются устройством.
WINBIO_CAPABILITIES могут содержать значения из следующей таблицы.
| Значение биометрических возможностей | Описание |
|---|---|
| WINBIO_CAPABILITY_SENSOR | Устройство может собирать биометрические данные. |
| WINBIO_CAPABILITY_MATCHING | Устройство может выполнять операции сопоставления. |
| WINBIO_CAPABILITY_STORAGE | На устройстве могут храниться биометрические шаблоны. |
| WINBIO_CAPABILITY_SECURE_STORAGE | Устройство может хранить защищенные данные, связанные с шаблоном. Безопасные данные освобождаются только с положительным совпадением. Устройство должно поддерживать по крайней мере алгоритм SHA-1 для безопасных вычислений хэша, который будет использоваться для хранения шаблонов в системном пуле. |
| WINBIO_CAPABILITY_PROCESSING | Устройство может обрабатывать образцы и превращать их в биометрические шаблоны. |
| WINBIO_CAPABILITY_ENCRYPTION | Устройство поддерживает шифрование примеров и шаблонов. |
| WINBIO_CAPABILITY_SIGNING | Устройство может подписывать захваченные данные. |
| WINBIO_CAPABILITY_NAVIGATION | Устройство можно использовать в качестве устройства навигации. Некоторые устройства и драйверы могут записывать данные в формате, который может быть преобразован приложением пользовательского режима в события навигации, как мышь. |
| WINBIO_CAPABILITY_INDICATOR | На устройстве есть индикатор, который можно включить или выключить. |
| WINBIO_CAPABILITY_VIRTUAL_SENSOR | Адаптер датчика управляет собственным подключением к биометрической технике. Примечание: Эта константа применяется только для Windows 10 и более поздних версий. |
| WINBIO_CAPABILITY_SECURE_SENSOR | Устройство поддерживает методы безопасности, доступные в интерфейсе адаптера подсистемы WinBio версии 4.0 или более поздней. Примечание: Эта константа применяется только для Windows 10 и более поздних версий. |
ManufacturerName
Структура типа WINBIO_STRING, содержащая имя изготовителя устройства.
ModelName
Структура типа WINBIO_STRING, содержащая имя модели устройства.
SerialNumber
Структура типа WINBIO_STRING, содержащая серийный номер устройства, если таковой существует.
FirmwareVersion
Структура типа WINBIO_VERSION , содержащая версию встроенного ПО, загруженную на устройство.
SupportedFormatEntries
Количество форматов, поддерживаемых драйвером и устройством. Должен быть хотя бы один формат, который является стандартным форматом Windows.
SupportedFormat[1]
Структура типа WINBIO_REGISTERED_FORMAT , содержащая список форматов, поддерживаемых драйвером и устройством.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | winbio_ioctl.h |