структура 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 |