структура 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

См. также раздел

IOCTL_BIOMETRIC_GET_ATTRIBUTES