WINBIO_ENGINE_INTERFACE-Struktur (winbio_adapter.h)
Die WINBIO_ENGINE_INTERFACE-Struktur enthält Zeiger auf Ihre benutzerdefinierten Engine-Adapterfunktionen. Das Windows Biometric Framework verwendet diese Struktur, um die Funktionen zu suchen.
Syntax
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;
Member
Version
Versionsnummer dieser Struktur.
Windows 10: Die Versionsnummer muss WINBIO_ENGINE_INTERFACE_VERSION_3 oder WINBIO_ENGINE_INTERFACE_VERSION_4 sein. Weitere Informationen zur Implementierung WINBIO_ENGINE_INTERFACE_VERSION_4 finden Sie unter Sensoranforderungen für sichere biometrische Daten.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012 und Windows 8: Die Versionsnummer muss WINBIO_ENGINE_INTERFACE_VERSION_2 sein.
Windows Server 2008 R2 und Windows 7: Die Versionsnummer muss WINBIO_ENGINE_INTERFACE_VERSION_1 sein.
Type
Der Typ des Adapters. Dies muss WINBIO_ADAPTER_TYPE_ENGINE sein.
Size
Die Größe (in Bytes) dieser Struktur. Legen Sie diesen Wert auf die Größe der WINBIO_ENGINE_INTERFACE-Struktur fest.
AdapterId
Eine GUID, die den Engine-Adapter eindeutig identifiziert. Sie müssen diesen Wert generieren.
Attach
Ein Zeiger auf Ihre Implementierung der EngineAdapterAttach-Funktion .
Detach
Ein Zeiger auf Ihre Implementierung der EngineAdapterDetach-Funktion .
ClearContext
Ein Zeiger auf Ihre Implementierung der EngineAdapterClearContext-Funktion .
QueryPreferredFormat
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryPreferredFormat-Funktion .
QueryIndexVectorSize
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryIndexVectorSize-Funktion .
QueryHashAlgorithms
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryHashAlgorithms-Funktion .
SetHashAlgorithm
Ein Zeiger auf Ihre Implementierung der EngineAdapterSetHashAlgorithm-Funktion .
QuerySampleHint
Ein Zeiger auf Ihre Implementierung der EngineAdapterQuerySampleHint-Funktion .
AcceptSampleData
Ein Zeiger auf Ihre Implementierung der EngineAdapterAcceptSampleData-Funktion .
ExportEngineData
Ein Zeiger auf Ihre Implementierung der EngineAdapterExportEngineData-Funktion .
VerifyFeatureSet
Ein Zeiger auf Ihre Implementierung der EngineAdapterVerifyFeatureSet-Funktion .
IdentifyFeatureSet
Ein Zeiger auf Ihre Implementierung der EngineAdapterIdentifyFeatureSet-Funktion .
CreateEnrollment
Ein Zeiger auf Ihre Implementierung der EngineAdapterCreateEnrollment-Funktion .
UpdateEnrollment
Ein Zeiger auf Ihre Implementierung der EngineAdapterUpdateEnrollment-Funktion .
GetEnrollmentStatus
Ein Zeiger auf Ihre Implementierung der EngineAdapterGetEnrollmentStatus-Funktion .
GetEnrollmentHash
Ein Zeiger auf Ihre Implementierung der EngineAdapterGetEnrollmentHash-Funktion .
CheckForDuplicate
Ein Zeiger auf Ihre Implementierung der EngineAdapterCheckForDuplicate-Funktion .
CommitEnrollment
Ein Zeiger auf Ihre Implementierung der EngineAdapterCommitEnrollment-Funktion .
DiscardEnrollment
Ein Zeiger auf Ihre Implementierung der EngineAdapterDiscardEnrollment-Funktion .
ControlUnit
Ein Zeiger auf Ihre Implementierung der EngineAdapterControlUnit-Funktion .
ControlUnitPrivileged
Ein Zeiger auf Ihre Implementierung der EngineAdapterControlUnitPrivileged-Funktion .
NotifyPowerChange
Ein Zeiger auf Ihre Implementierung der EngineAdapterNotifyPowerChange-Funktion . Dieses Element wird ab Windows 8 unterstützt.
Reserved_1
Dieses Feld ist reserviert und sollte auf NULL festgelegt werden.
PipelineInit
Ein Zeiger auf Ihre Implementierung der EngineAdapterPipelineInit-Funktion . Dieser Member wird ab Windows 10 unterstützt.
PipelineCleanup
Ein Zeiger auf Ihre Implementierung der EngineAdapterPipelineCleanup-Funktion . Dieser Member wird ab Windows 10 unterstützt.
Activate
Ein Zeiger auf Ihre Implementierung der EngineAdapterActivate-Funktion . Dieser Member wird ab Windows 10 unterstützt.
Deactivate
Ein Zeiger auf Ihre Implementierung der EngineAdapterDeactivate-Funktion . Dieser Member wird ab Windows 10 unterstützt.
QueryExtendedInfo
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryExtendedInfo-Funktion . Dieser Member wird ab Windows 10 unterstützt.
IdentifyAll
Ein Zeiger auf Ihre Implementierung der EngineAdapterIdentifyAll-Funktion . Dieser Member wird ab Windows 10 unterstützt.
SetEnrollmentSelector
Ein Zeiger auf Ihre Implementierung der EngineAdapterSetEnrollmentSelector-Funktion . Dieser Member wird ab Windows 10 unterstützt.
SetEnrollmentParameters
Ein Zeiger auf Ihre Implementierung der EngineAdapterSetEnrollmentParameters-Funktion . Dieser Member wird ab Windows 10 unterstützt.
QueryExtendedEnrollmentStatus
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryExtendedEnrollmentStatus-Funktion . Dieser Member wird ab Windows 10 unterstützt.
RefreshCache
Ein Zeiger auf Ihre Implementierung der EngineAdapterRefreshCache-Funktion . Dieser Member wird ab Windows 10 unterstützt.
SelectCalibrationFormat
Ein Zeiger auf Ihre Implementierung der EngineAdapterSelectCalibrationFormat-Funktion . Dieser Member wird ab Windows 10 unterstützt.
QueryCalibrationData
Ein Zeiger auf Ihre Implementierung der EngineAdapterQueryCalibrationData-Funktion . Dieser Member wird ab Windows 10 unterstützt.
SetAccountPolicy
Ein Zeiger auf Ihre Implementierung der EngineAdapterSetAccountPolicy-Funktion . Dieser Member wird ab Windows 10 unterstützt.
CreateKey
Ein Zeiger auf Ihre Implementierung der EngineAdapterCreateKey-Funktion . Dieser Member wird ab Windows 10 Version 1607 unterstützt.
IdentifyFeatureSetSecure
Ein Zeiger auf Ihre Implementierung der EngineAdapterIdentifyFeatureSetSecure-Funktion . Dieser Member wird ab Windows 10 Version 1607 unterstützt.
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | winbio_adapter.h |