Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |