структура 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, содержащая версию WBDI WinBio, поддерживаемую драйвером. Чтобы быть совместимым со службой 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 |