通过

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