Windows 生物特徵辨識架構

Windows 生物特徵辨識架構技術概觀。

若要開發 Windows 生物特徵辨識架構，您需要下列標頭：

• winbio.h
• winbio_adapter.h

如需這項技術的程式設計指導方針，請參閱：

• Windows 生物特徵辨識架構

列舉

WINBIO_ASYNC_NOTIFICATION_METHOD 定義常數，指定非同步作業的完成通知如何傳遞至用戶端應用程式。

函式

PIBIO_ENGINE_ACCEPT_SAMPLE_DATA_FN 接受原始生物特徵辨識範例並擷取功能集。
PIBIO_ENGINE_ACTI加值稅E_FN 讓引擎配接器有機會執行讓感應器元件脫離閒置狀態所需的任何工作。
PIBIO_ENGINE_ATTACH_FN 將引擎配接器新增至生物特徵辨識單位的處理管線。
PIBIO_ENGINE_CHECK_FOR_DUPLICATE_FN 判斷管線中的新範本是否會複製資料庫中已儲存的任何範本，而不論與範本相關聯的身分識別為何。
PIBIO_ENGINE_CLEAR_CONTEXT_FN 為新的作業準備生物特徵辨識單位的處理管線。E
PIBIO_ENGINE_COMMIT_ENROLLMENT_FN 完成註冊物件、將它轉換成範本，並將範本儲存在資料庫中。
PIBIO_ENGINE_CONTROL_UNIT_FN 執行不需要提高許可權的廠商定義控制項作業。E
PIBIO_ENGINE_CONTROL_UNIT_PRIVILEGED_FN 執行需要提高許可權的廠商定義控制項作業。E
PIBIO_ENGINE_CREATE_ENROLLMENT_FN 初始化生物特徵辨識單位管線中的註冊物件。
PIBIO_ENGINE_CREATE_KEY_FN 由 Windows 生物特徵辨識架構呼叫，將 HMAC 金鑰推送至感應器。 當架構呼叫 EngineAdapterIdentifyFeatureSetSecure 時，傳回的金鑰識別碼將會傳回生物特徵辨識單位。
PIBIO_ENGINE_DEACTI加值稅E_FN 讓引擎配接器有機會執行任何將感應器元件置於閒置狀態所需的工作。
PIBIO_ENGINE_DETACH_FN 釋放附加至管線的介面卡特定資源。E
PIBIO_ENGINE_DISCARD_ENROLLMENT_FN 從管線中刪除中繼註冊狀態資訊。
PIBIO_ENGINE_EXPORT_ENGINE_DATA_FN 從標準生物特徵辨識資訊記錄中的引擎擷取最近處理之功能集或範本的複本。
PIBIO_ENGINE_GET_ENROLLMENT_HASH_FN 擷取管線中已完成註冊範本的雜湊。
PIBIO_ENGINE_GET_ENROLLMENT_STATUS_FN 判斷註冊物件是否已準備好認可至管線。
PIBIO_ENGINE_IDENTIFY_ALL_FN 決定目前在相機畫面中之任何人的身分識別。
PIBIO_ENGINE_IDENTIFY_FEATURE_SET_FN 從目前的功能集建置範本，並在資料庫中找出相符的範本。
PIBIO_ENGINE_IDENTIFY_FEATURE_SET_SECURE_FN 由 Windows 生物特徵辨識架構呼叫，以從目前的功能集建置範本，並在資料庫中找出相符的範本。
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN 接收電腦電源狀態變更的相關通知，並據以準備引擎配接器。
PIBIO_ENGINE_PIPELINE_CLEANUP_FN 讓引擎配接器有機會執行任何需要儲存體配接器協助的清除。
PIBIO_ENGINE_PIPELINE_INIT_FN 讓引擎配接器有機會執行任何維持不完整的初始化。
PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN 從引擎配接器取得一組擷取後校正資料。
PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN 查詢WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS屬性。
PIBIO_ENGINE_QUERY_EXTENDED_INFO_FN 決定生物特徵辨識引擎元件的功能和限制。
PIBIO_ENGINE_QUERY_HASH_ALGORITHMS_FN 擷取代表引擎配接器所支援雜湊演算法的物件識別碼陣列。
PIBIO_ENGINE_QUERY_INDEX_VECTOR_SIZE_FN 擷取引擎配接器所使用的索引向量大小。
PIBIO_ENGINE_QUERY_PREFERRED_FORMAT_FN 決定引擎配接器慣用的輸入資料格式。
PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN 擷取引擎配接器建構註冊範本所需的正確範例數目。
PIBIO_ENGINE_REFRESH_CACHE_FN 通知引擎配接器，它應該捨棄任何可能保留在記憶體中的快取範本。
PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN 由 Windows 生物特徵辨識架構呼叫，以判斷引擎配接器想要使用的感應器配接器校正格式。
PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN 設定引擎配接器所使用的擴充預設和每個使用者反詐騙原則。
PIBIO_ENGINE_SET_ENROLLMENT_PARAMETERS_FN 提供引擎配接器有關註冊作業的其他資訊。
PIBIO_ENGINE_SET_ENROLLMENT_SELECTOR_FN 告知引擎配接器要追蹤目前註冊作業的人員。
PIBIO_ENGINE_SET_HASH_ALGORITHM_FN 選取雜湊演算法以供後續作業使用。
PIBIO_ENGINE_UPDATE_ENROLLMENT_FN 將目前的功能集加入至註冊物件。
PIBIO_ENGINE_VERIFY_FEATURE_SET_FN 比較目前功能集中的範本與資料庫中的特定範本。
PIBIO_SENSOR_ACCEPT_CALIBRATION_DATA_FN 將校正資料從引擎配接器傳遞至感應器配接器。
PIBIO_SENSOR_ACTI加值稅E_FN 讓感應器配接器有機會執行讓感應器元件脫離閒置狀態所需的任何工作。
PIBIO_SENSOR_ATTACH_FN 將感應器配接器新增至生物特徵辨識單位的處理管線。
PIBIO_SENSOR_CANCEL_FN 取消所有擱置的感應器作業。
PIBIO_SENSOR_CLEAR_CONTEXT_FN PIBIO_SENSOR_CLEAR_CONTEXT_FN (winbio_adapter.h) 為新作業準備生物特徵辨識單位的處理管線。
PIBIO_SENSOR_CONTROL_UNIT_FN PIBIO_SENSOR_CONTROL_UNIT_FN (winbio_adapter.h) 會執行不需要提高許可權的廠商定義控制項作業。
PIBIO_SENSOR_CONTROL_UNIT_PRIVILEGED_FN PIBIO_SENSOR_CONTROL_UNIT_PRIVILEGED_FN回呼函式 (winbio_adapter.h) 會執行需要提高許可權的廠商定義控制作業。
PIBIO_SENSOR_DEACTI加值稅E_FN 讓感應器配接器有機會執行將感應器元件置於閒置狀態所需的任何工作。
PIBIO_SENSOR_DETACH_FN 釋放附加至管線的配接器特定資源。
PIBIO_SENSOR_EXPORT_SENSOR_DATA_FN 擷取以標準WINBIO_BIR結構格式化的最新擷取生物特徵辨識樣本。
PIBIO_SENSOR_FINISH_CAPTURE_FN PIBIO_SENSOR_FINISH_CAPTURE_FN回呼 (winbio_adapter.h) 會擷取值，指出感應器指標是否開啟或關閉。
PIBIO_SENSOR_GET_INDICATOR_STATUS_FN PIBIO_SENSOR_GET_INDICATOR_STATUS_FN回呼函式 (winbio_adapter.h) 會擷取值，指出感應器指標是開啟還是關閉。
PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN 接收有關電腦電源狀態變更的通知，並據以準備感應器介面卡。
PIBIO_SENSOR_PIPELINE_CLEANUP_FN 讓感應器配接器有機會在 中執行任何需要引擎或儲存配接器元件協助的清除。
PIBIO_SENSOR_PIPELINE_INIT_FN 讓感應器配接器有機會執行任何維持不完整的初始化，而且需要引擎或儲存配接器元件的協助。
PIBIO_SENSOR_PUSH_DATA_TO_ENGINE_FN 讓引擎配接器可以使用範例緩衝區的目前內容。
PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN 決定感應器配接器支援的校正格式集。
PIBIO_SENSOR_QUERY_EXTENDED_INFO_FN 決定生物特徵辨識感應器元件的功能和限制。
PIBIO_SENSOR_QUERY_STATUS_FN 擷取感應器裝置目前狀態的相關資訊。
PIBIO_SENSOR_RESET_FN 重新初始化感應器。
PIBIO_SENSOR_SET_CALIBRATION_FORMAT_FN 通知感應器配接器，引擎配接器已選取特定的校正資料格式。
PIBIO_SENSOR_SET_INDICATOR_STATUS_FN 開啟或關閉感應器指示器。
PIBIO_SENSOR_SET_MODE_FN 設定感應器配接器模式。
PIBIO_SENSOR_START_CAPTURE_FN 開始非同步生物特徵辨識擷取。
PIBIO_STORAGE_ACTI加值稅E_FN 讓儲存體配接器有機會執行讓儲存體元件脫離閒置狀態所需的任何工作。
PIBIO_STORAGE_ADD_RECORD_FN 將範本新增至資料庫。
PIBIO_STORAGE_ATTACH_FN 將存放裝置配接器新增至生物特徵辨識單位的處理管線。
PIBIO_STORAGE_CLEAR_CONTEXT_FN PIBIO_STORAGE_CLEAR_CONTEXT_FN回呼函式 (winbio_adapter.h) 會準備新作業生物特徵辨識單位的處理管線。
PIBIO_STORAGE_CLOSE_DATABASE_FN 關閉與管線相關聯的資料庫，並釋放所有相關資源。
PIBIO_STORAGE_CONTROL_UNIT_FN PIBIO_STORAGE_CONTROL_UNIT_FN回呼函式 (winbio_adapter.h) 會執行不需要提高許可權的廠商定義控制作業。
PIBIO_STORAGE_CONTROL_UNIT_PRIVILEGED_FN PIBIO_STORAGE_CONTROL_UNIT_PRIVILEGED_FN回呼函式 (winbio_adapter.h) 會執行需要提高許可權的廠商定義控制作業。
PIBIO_STORAGE_CREATE_DATABASE_FN 建立並設定新的資料庫。
PIBIO_STORAGE_DEACTI加值稅E_FN 讓儲存體配接器有機會執行將儲存體元件置於閒置狀態所需的任何工作。
PIBIO_STORAGE_DELETE_RECORD_FN 從資料庫刪除一或多個範本。
PIBIO_STORAGE_DETACH_FN 釋放附加至管線的配接器特定資源。S
PIBIO_STORAGE_ERASE_DATABASE_FN 清除資料庫並將其標示為刪除。
PIBIO_STORAGE_FIRST_RECORD_FN 將結果集資料指標放在集合中的第一筆記錄上。
PIBIO_STORAGE_GET_CURRENT_RECORD_FN 擷取管線結果集中目前記錄的內容。
PIBIO_STORAGE_GET_DATA_FORMAT_FN 擷取與管線相關聯之目前資料庫所使用的格式和版本資訊。
PIBIO_STORAGE_GET_DATABASE_SIZE_FN 擷取資料庫大小和可用空間。
PIBIO_STORAGE_GET_RECORD_COUNT_FN 擷取管線結果集中的範本記錄數目。
PIBIO_STORAGE_NEXT_RECORD_FN 將結果集資料指標往前移動一筆記錄。
PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN 接收有關電腦電源狀態變更的通知，並據以準備存放裝置介面卡。
PIBIO_STORAGE_OPEN_DATABASE_FN 開啟資料庫以供儲存體配接器使用。
PIBIO_STORAGE_PIPELINE_CLEANUP_FN 讓儲存體配接器有機會執行任何清除，以準備關閉範本資料庫。
PIBIO_STORAGE_PIPELINE_INIT_FN 讓儲存體配接器有機會執行任何維持不完整的初始化。
PIBIO_STORAGE_QUERY_BY_CONTENT_FN 查詢目前針對與指定索引向量相關聯的範本開啟的資料庫。
PIBIO_STORAGE_QUERY_BY_SUBJECT_FN 查詢目前針對與指定身分識別和子因素相關聯的範本所開啟的資料庫。
PIBIO_STORAGE_QUERY_EXTENDED_INFO_FN 決定生物特徵辨識儲存元件的功能和限制。
PWINBIO_ASYNC_COMPLETION_CALLBACK 通知用戶端應用程式使用 WinBioAsyncOpenSession 或 WinBioAsyncOpenFramework 啟動的非同步作業已完成。
PWINBIO_CAPTURE_CALLBACK 從非同步 WinBioCaptureSampleWithCallback 函式傳回結果。
PWINBIO_ENROLL_CAPTURE_CALLBACK 由 Windows 生物特徵辨識架構呼叫，以從非同步 WinBioEnrollCaptureWithCallback 函式傳回結果。
PWINBIO_EVENT_CALLBACK 從非同步 WinBioRegisterEventMonitor 函式傳回結果。
PWINBIO_IDENTIFY_CALLBACK 從非同步 WinBioIdentifyWithCallback 函式傳回結果。
PWINBIO_LOCATE_SENSOR_CALLBACK 從非同步 WinBioLocateSensorWithCallback 函式傳回結果。
PWINBIO_VERIFY_CALLBACK 從非同步 WinBioVerifyWithCallback 函式傳回結果。
WbioQueryEngineInterface 擷取引擎配接器之WINBIO_ENGINE_INTERFACE結構的指標。
WbioQuerySensorInterface 擷取感應器介面卡WINBIO_SENSOR_INTERFACE結構的指標。
WbioQueryStorageInterface 擷取儲存體配接器WINBIO_STORAGE_INTERFACE結構的指標。
WinBioAcquireFocus 取得視窗焦點。
WinBioAsyncEnumBiometricUnits 以非同步方式列舉符合輸入因數類型的所有附加生物特徵辨識單位。
WinBioAsyncEnumDatabases 以非同步方式列舉符合指定類型的所有已註冊資料庫。
WinBioAsyncEnumServiceProviders 以非同步方式傳回已安裝生物特徵辨識服務提供者的相關資訊。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioAsyncMonitorFrameworkChanges 啟動生物特徵辨識架構變更的非同步監視。
WinBioAsyncOpenFramework 開啟生物特徵辨識架構的控制碼。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioAsyncOpenSession 以非同步方式連線到生物特徵辨識服務提供者和一或多個生物特徵辨識單位。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioCancel 取消指定會話的所有擱置生物特徵辨識作業。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioCaptureSample 擷取生物特徵辨識樣本，並以未經處理或已處理的資料填入 BIR) 生物特徵辨識資訊 (記錄。
WinBioCaptureSampleWithCallback 以非同步方式擷取生物特徵辨識範例，並在 BIR) (記錄中傳回原始或已處理的資料。
WinBioCloseFramework 關閉先前使用 WinBioAsyncOpenFramework 開啟的架構控制碼。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioCloseSession 關閉生物特徵辨識會話並釋放相關聯的資源。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioControlUnit 可讓呼叫端在生物特徵辨識單位上執行廠商定義的控制作業。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioControlUnitPrivileged 可讓呼叫端在生物特徵辨識單位上執行具特殊許可權廠商定義的控制作業。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioDeleteTemplate 從範本存放區中刪除生物特徵辨識範本。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnrollBegin 起始生物特徵辨識註冊順序，並建立空的生物特徵辨識範本。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnrollCapture 擷取生物特徵辨識範例，並將其新增至範本。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnrollCaptureWithCallback 以非同步方式擷取生物特徵辨識範例，並將其新增至範本。
WinBioEnrollCommit 完成擱置生物特徵辨識範本，並將它儲存至與用於註冊之生物特徵辨識單位相關聯的資料庫。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnrollDiscard 結束註冊順序，並捨棄擱置中的生物特徵辨識範本。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnrollSelect 指定當代表多個個人的資料出現在範例緩衝區中時，您想要註冊的個別。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnumBiometricUnits 列舉符合輸入類型的所有附加生物特徵辨識單位。
WinBioEnumDatabases 列舉所有符合指定型別的已註冊資料庫。
WinBioEnumEnrollments 擷取已註冊指定身分識別和生物特徵辨識單位的生物特徵辨識子因素。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioEnumServiceProviders 擷取已安裝生物特徵辨識服務提供者的相關資訊。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioFree 透過先前呼叫 Windows 生物特徵辨識架構 API 函式，釋放為用戶端應用程式配置的記憶體。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioGetCredentialState 擷取值，指定是否已為指定的使用者設定認證。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioGetDomainLogonSetting 擷取值，指定使用者是否可以使用生物特徵辨識資訊登入網域。
WinBioGetEnabledSetting 擷取值，指定 Windows 生物特徵辨識架構目前是否已啟用。
WinBioGetEnrolledFactors 取得電腦上所指定使用者所擁有生物特徵辨識註冊的相關資訊。
WinBioGetLogonSetting 擷取值，指出使用者是否可以使用生物特徵辨識資訊登入。
WinBioGetProperty 擷取會話、單位或範本屬性。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioIdentify 擷取生物特徵辨識樣本，並判斷它是否符合現有的生物特徵辨識範本。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioIdentifyWithCallback 以非同步方式擷取生物特徵辨識樣本，並判斷它是否符合現有的生物特徵辨識範本。
WinBioLocateSensor 擷取使用者以互動方式選取生物特徵辨識單位的識別碼。
WinBioLocateSensorWithCallback 以非同步方式擷取使用者以互動方式選取生物特徵辨識單位的識別碼。
WinBioLockUnit 鎖定生物特徵辨識單位供單一會話獨佔使用。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioLogonIdentifiedUser 讓快速的使用者切換至與生物特徵辨識會話所執行最後一次成功識別作業相關聯的帳戶。
WinBioMonitorPresence 開啟指定生物特徵辨識單位的臉部辨識或鳶尾花監視機制。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioOpenSession 連線到生物特徵辨識服務提供者和一或多個生物特徵辨識單位。
WinBioRegisterEventMonitor 註冊回呼函式，以接收與開啟會話相關聯之服務提供者的事件通知。
WinBioReleaseFocus 釋放視窗焦點。
WinBioRemoveAllCredentials 從存放區中移除所有認證。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioRemoveAllDomainCredentials 從存放區中移除目前網域的所有使用者認證。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioRemoveCredential 刪除指定使用者生物特徵辨識登入認證。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioSetCredential 儲存目前使用者生物特徵辨識登入認證。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioSetProperty 設定與生物特徵辨識會話、單位、範本或帳戶相關聯的標準屬性值。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioUnlockUnit 釋放指定生物特徵辨識單位上的會話鎖定。
WinBioUnregisterEventMonitor 從與開啟生物特徵辨識會話相關聯的服務提供者取消事件通知。
WinBioVerify 擷取生物特徵辨識樣本，並判斷樣本是否對應至指定的使用者身分識別。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。
WinBioVerifyWithCallback 以非同步方式擷取生物特徵辨識樣本，並判斷樣本是否對應至指定的使用者身分識別。
WinBioWait 封鎖呼叫端執行，直到會話的所有擱置生物特徵辨識作業都已完成或取消為止。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。

結構

WINBIO_ENGINE_INTERFACE 包含自訂引擎配接器函式的指標。
WINBIO_SENSOR_INTERFACE 包含自訂感應器配接器函式的指標。
WINBIO_STORAGE_INTERFACE 包含自訂儲存體配接器函式的指標。
WINBIO_ADAPTER_INTERFACE_VERSION 包含引擎、感應器和儲存體配接器介面資料表中使用的主要和次要版本號碼。
WINBIO_ASYNC_RESULT 包含非同步作業的結果。
WINBIO_PIPELINE 包含單一生物特徵辨識單位中感應器、引擎和儲存配接器元件所使用的共用內容資訊。
WINBIO_STORAGE_RECORD 包含標準格式的生物特徵辨識範本和相關聯的資料。