Windows 生物识别框架

Windows 生物识别框架技术概述。

若要开发 Windows 生物识别框架，需要以下标头：

• winbio.h
• winbio_adapter.h

有关此技术的编程指南，请参阅：

• Windows 生物识别框架

枚举

WINBIO_ASYNC_NOTIFICATION_METHOD 定义常量，这些常量指定异步操作的完成通知如何传递到客户端应用程序。

函数

PIBIO_ENGINE_ACCEPT_SAMPLE_DATA_FN 接受原始生物识别样本并提取特征集。
PIBIO_ENGINE_ACTIVATE_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_DEACTIVATE_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_ACTIVATE_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_DEACTIVATE_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_ACTIVATE_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_DEACTIVATE_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 检索用户以交互方式选择的生物识别单元的 ID 号。
WinBioLocateSensorWithCallback 异步检索用户以交互方式选择的生物识别单元的 ID 号。
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 包含标准格式的生物识别模板和关联数据。