共用方式為


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 服務相容,WinBioVersion 除了小於或等於目前 WinBio 服務次要版本的次要版本之外,還必須包含與目前 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