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 值，该值指示包含 I/O 操作的状态详细信息。 下表包含可能的值。

状态值 说明
S_OK 操作已成功完成。
HRESULT_FROM_NT (STATUS_IO_DEVICE_ERROR) 驱动程序无法从设备收集必要的信息。

WinBioVersion

WINBIO_VERSION 类型的结构，其中包含驱动程序支持的 WinBio WBDI 版本。 为了与 WinBio 服务兼容，除了小于或等于 WinBio 服务的当前次要版本的次要版本外， WinBioVersion 还必须包含与 WinBio 服务的当前主版本相同的主版本。

SensorType

WINBIO_BIOMETRIC_TYPE类型的 DWORD 位掩码，其中包含传感器收集的生物识别数据。 在 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