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 |