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可以包含下表中的值。

生物特徵辨識子類型值	Description
WINBIO_FP_SENSOR_SUBTYPE_SWIPE	裝置需要使用者撥動感測器上的指尖。
WINBIO_FP_SENSOR_SUBTYPE_TOUCH	裝置需要使用者將其整個指紋放在感測器面板上。

Capabilities

WINBIO_CAPABILITIES子類型，指出裝置支援哪些功能。

WINBIO_CAPABILITIES可以包含下表中的值。

生物特徵辨識功能值	Description
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