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 |