WINBIO_ENGINE_INTERFACE 结构 (winbio_adapter.h)
WINBIO_ENGINE_INTERFACE 结构包含指向自定义引擎适配器函数的指针。 Windows 生物识别框架使用此结构来查找函数。
语法
typedef struct _WINBIO_ENGINE_INTERFACE {
WINBIO_ADAPTER_INTERFACE_VERSION Version;
WINBIO_ADAPTER_TYPE Type;
SIZE_T Size;
GUID AdapterId;
PIBIO_ENGINE_ATTACH_FN Attach;
PIBIO_ENGINE_DETACH_FN Detach;
PIBIO_ENGINE_CLEAR_CONTEXT_FN ClearContext;
PIBIO_ENGINE_QUERY_PREFERRED_FORMAT_FN QueryPreferredFormat;
PIBIO_ENGINE_QUERY_INDEX_VECTOR_SIZE_FN QueryIndexVectorSize;
PIBIO_ENGINE_QUERY_HASH_ALGORITHMS_FN QueryHashAlgorithms;
PIBIO_ENGINE_SET_HASH_ALGORITHM_FN SetHashAlgorithm;
PIBIO_ENGINE_QUERY_SAMPLE_HINT_FN QuerySampleHint;
PIBIO_ENGINE_ACCEPT_SAMPLE_DATA_FN AcceptSampleData;
PIBIO_ENGINE_EXPORT_ENGINE_DATA_FN ExportEngineData;
PIBIO_ENGINE_VERIFY_FEATURE_SET_FN VerifyFeatureSet;
PIBIO_ENGINE_IDENTIFY_FEATURE_SET_FN IdentifyFeatureSet;
PIBIO_ENGINE_CREATE_ENROLLMENT_FN CreateEnrollment;
PIBIO_ENGINE_UPDATE_ENROLLMENT_FN UpdateEnrollment;
PIBIO_ENGINE_GET_ENROLLMENT_STATUS_FN GetEnrollmentStatus;
PIBIO_ENGINE_GET_ENROLLMENT_HASH_FN GetEnrollmentHash;
PIBIO_ENGINE_CHECK_FOR_DUPLICATE_FN CheckForDuplicate;
PIBIO_ENGINE_COMMIT_ENROLLMENT_FN CommitEnrollment;
PIBIO_ENGINE_DISCARD_ENROLLMENT_FN DiscardEnrollment;
PIBIO_ENGINE_CONTROL_UNIT_FN ControlUnit;
PIBIO_ENGINE_CONTROL_UNIT_PRIVILEGED_FN ControlUnitPrivileged;
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN NotifyPowerChange;
PIBIO_ENGINE_RESERVED_1_FN Reserved_1;
PIBIO_ENGINE_PIPELINE_INIT_FN PipelineInit;
PIBIO_ENGINE_PIPELINE_CLEANUP_FN PipelineCleanup;
PIBIO_ENGINE_ACTIVATE_FN Activate;
PIBIO_ENGINE_DEACTIVATE_FN Deactivate;
PIBIO_ENGINE_QUERY_EXTENDED_INFO_FN QueryExtendedInfo;
PIBIO_ENGINE_IDENTIFY_ALL_FN IdentifyAll;
PIBIO_ENGINE_SET_ENROLLMENT_SELECTOR_FN SetEnrollmentSelector;
PIBIO_ENGINE_SET_ENROLLMENT_PARAMETERS_FN SetEnrollmentParameters;
PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN QueryExtendedEnrollmentStatus;
PIBIO_ENGINE_REFRESH_CACHE_FN RefreshCache;
PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN SelectCalibrationFormat;
PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN QueryCalibrationData;
PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN SetAccountPolicy;
PIBIO_ENGINE_CREATE_KEY_FN CreateKey;
PIBIO_ENGINE_IDENTIFY_FEATURE_SET_SECURE_FN IdentifyFeatureSetSecure;
PIBIO_ENGINE_ACCEPT_PRIVATE_SENSOR_TYPE_INFO_FN AcceptPrivateSensorTypeInfo;
PIBIO_ENGINE_CREATE_ENROLLMENT_AUTHENTICATED_FN CreateEnrollmentAuthenticated;
PIBIO_ENGINE_IDENTIFY_FEATURE_SET_AUTHENTICATED_FN IdentifyFeatureSetAuthenticated;
} *PWINBIO_ENGINE_INTERFACE, WINBIO_ENGINE_INTERFACE;
成员
Version
此结构的版本号。
Windows 10：版本号必须为WINBIO_ENGINE_INTERFACE_VERSION_3或WINBIO_ENGINE_INTERFACE_VERSION_4。 有关实现 WINBIO_ENGINE_INTERFACE_VERSION_4的详细信息，请参阅 安全生物识别的传感器要求。
Windows Server 2012 R2、Windows 8.1、Windows Server 2012 和 Windows 8：版本号必须WINBIO_ENGINE_INTERFACE_VERSION_2。
Windows Server 2008 R2 和 Windows 7： 版本号必须 WINBIO_ENGINE_INTERFACE_VERSION_1。
Type
适配器的类型。 这必须 WINBIO_ADAPTER_TYPE_ENGINE。
Size
此结构的大小（以字节为单位）。 将此值设置为 WINBIO_ENGINE_INTERFACE 结构的大小。
AdapterId
唯一标识引擎适配器的 GUID。 必须生成此值。
Attach
指向 EngineAdapterAttach 函数实现的指针。
Detach
指向 EngineAdapterDetach 函数实现的指针。
ClearContext
指向 EngineAdapterClearContext 函数实现的指针。
QueryPreferredFormat
指向 EngineAdapterQueryPreferredFormat 函数实现的指针。
QueryIndexVectorSize
指向 EngineAdapterQueryIndexVectorSize 函数实现的指针。
QueryHashAlgorithms
指向 EngineAdapterQueryHashAlgorithms 函数实现的指针。
SetHashAlgorithm
指向 EngineAdapterSetHashAlgorithm 函数实现的指针。
QuerySampleHint
指向 EngineAdapterQuerySampleHint 函数实现的指针。
AcceptSampleData
指向 EngineAdapterAcceptSampleData 函数实现的指针。
ExportEngineData
指向 EngineAdapterExportEngineData 函数实现的指针。
VerifyFeatureSet
指向 EngineAdapterVerifyFeatureSet 函数实现的指针。
IdentifyFeatureSet
指向 EngineAdapterIdentifyFeatureSet 函数实现的指针。
CreateEnrollment
指向 EngineAdapterCreateEnrollment 函数实现的指针。
UpdateEnrollment
指向 EngineAdapterUpdateEnrollment 函数实现的指针。
GetEnrollmentStatus
指向 EngineAdapterGetEnrollmentStatus 函数实现的指针。
GetEnrollmentHash
指向 EngineAdapterGetEnrollmentHash 函数实现的指针。
CheckForDuplicate
指向 EngineAdapterCheckForDuplicate 函数实现的指针。
CommitEnrollment
指向 EngineAdapterCommitEnrollment 函数实现的指针。
DiscardEnrollment
指向 EngineAdapterDiscardEnrollment 函数实现的指针。
ControlUnit
指向 EngineAdapterControlUnit 函数实现的指针。
ControlUnitPrivileged
指向 EngineAdapterControlUnitPrivileged 函数实现的指针。
NotifyPowerChange
指向 EngineAdapterNotifyPowerChange 函数实现的指针。 从 Windows 8 开始支持此成员。
Reserved_1
此字段为保留字段，应设置为 NULL。
PipelineInit
指向 EngineAdapterPipelineInit 函数实现的指针。 从 Windows 10 开始支持此成员。
PipelineCleanup
指向 EngineAdapterPipelineCleanup 函数实现的指针。 从 Windows 10 开始支持此成员。
Activate
指向 EngineAdapterActivate 函数实现的指针。 从 Windows 10 开始支持此成员。
Deactivate
指向 EngineAdapterDeactivate 函数实现的指针。 从 Windows 10 开始支持此成员。
QueryExtendedInfo
指向 EngineAdapterQueryExtendedInfo 函数实现的指针。 从 Windows 10 开始支持此成员。
IdentifyAll
指向 EngineAdapterIdentifyAll 函数实现的指针。 从 Windows 10 开始支持此成员。
SetEnrollmentSelector
指向 EngineAdapterSetEnrollmentSelector 函数实现的指针。 从 Windows 10 开始支持此成员。
SetEnrollmentParameters
指向 EngineAdapterSetEnrollmentParameters 函数实现的指针。 从 Windows 10 开始支持此成员。
QueryExtendedEnrollmentStatus
指向 EngineAdapterQueryExtendedEnrollmentStatus 函数实现的指针。 从 Windows 10 开始支持此成员。
RefreshCache
指向 EngineAdapterRefreshCache 函数实现的指针。 从 Windows 10 开始支持此成员。
SelectCalibrationFormat
指向 EngineAdapterSelectCalibrationFormat 函数实现的指针。 从 Windows 10 开始支持此成员。
QueryCalibrationData
指向 EngineAdapterQueryCalibrationData 函数实现的指针。 从 Windows 10 开始支持此成员。
SetAccountPolicy
指向 EngineAdapterSetAccountPolicy 函数实现的指针。 从 Windows 10 开始支持此成员。
CreateKey
指向 EngineAdapterCreateKey 函数实现的指针。 从 Windows 10 版本 1607 开始支持此成员。
IdentifyFeatureSetSecure
指向 EngineAdapterIdentifyFeatureSetSecure 函数实现的指针。 从 Windows 10 版本 1607 开始支持此成员。
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | winbio_adapter.h |