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 |