struttura WINBIO_ENGINE_INTERFACE (winbio_adapter.h)
La struttura WINBIO_ENGINE_INTERFACE contiene puntatori alle funzioni dell'adattatore del motore personalizzato. Windows Biometric Framework usa questa struttura per individuare le funzioni.
Sintassi
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;
Members
Version
Numero di versione di questa struttura.
Windows 10: il numero di versione deve essere WINBIO_ENGINE_INTERFACE_VERSION_3 o WINBIO_ENGINE_INTERFACE_VERSION_4. Per altre informazioni sull'implementazione di WINBIO_ENGINE_INTERFACE_VERSION_4, vedere Requisiti dei sensori per la biometria sicura.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012 e Windows 8: il numero di versione deve essere WINBIO_ENGINE_INTERFACE_VERSION_2.
Windows Server 2008 R2 e Windows 7: Il numero di versione deve essere WINBIO_ENGINE_INTERFACE_VERSION_1.
Type
Tipo di adattatore. Deve essere WINBIO_ADAPTER_TYPE_ENGINE.
Size
Dimensione, in byte, della struttura. Impostare questo valore sulle dimensioni della struttura WINBIO_ENGINE_INTERFACE .
AdapterId
GUID che identifica in modo univoco l'adattatore del motore. È necessario generare questo valore.
Attach
Puntatore all'implementazione della funzione EngineAdapterAttach .
Detach
Puntatore all'implementazione della funzione EngineAdapterDetach .
ClearContext
Puntatore all'implementazione della funzione EngineAdapterClearContext .
QueryPreferredFormat
Puntatore all'implementazione della funzione EngineAdapterQueryPreferredFormat .
QueryIndexVectorSize
Puntatore all'implementazione della funzione EngineAdapterQueryIndexVectorSize .
QueryHashAlgorithms
Puntatore all'implementazione della funzione EngineAdapterQueryHashAlgorithms .
SetHashAlgorithm
Puntatore all'implementazione della funzione EngineAdapterSetHashAlgorithm .
QuerySampleHint
Puntatore all'implementazione della funzione EngineAdapterQuerySampleHint .
AcceptSampleData
Puntatore all'implementazione della funzione EngineAdapterAcceptSampleData .
ExportEngineData
Puntatore all'implementazione della funzione EngineAdapterExportEngineData .
VerifyFeatureSet
Puntatore all'implementazione della funzione EngineAdapterVerifyFeatureSet .
IdentifyFeatureSet
Puntatore all'implementazione della funzione EngineAdapterIdentifyFeatureSet .
CreateEnrollment
Puntatore all'implementazione della funzione EngineAdapterCreateEnrollment .
UpdateEnrollment
Puntatore all'implementazione della funzione EngineAdapterUpdateEnrollment .
GetEnrollmentStatus
Puntatore all'implementazione della funzione EngineAdapterGetEnrollmentStatus .
GetEnrollmentHash
Puntatore all'implementazione della funzione EngineAdapterGetEnrollmentHash .
CheckForDuplicate
Puntatore all'implementazione della funzione EngineAdapterCheckForDuplicate .
CommitEnrollment
Puntatore all'implementazione della funzione EngineAdapterCommitEnrollment .
DiscardEnrollment
Puntatore all'implementazione della funzione EngineAdapterDiscardEnrollment .
ControlUnit
Puntatore all'implementazione della funzione EngineAdapterControlUnit .
ControlUnitPrivileged
Puntatore all'implementazione della funzione EngineAdapterControlUnitPrivileged .
NotifyPowerChange
Puntatore all'implementazione della funzione EngineAdapterNotifyPowerChange . Questo membro è supportato a partire da Windows 8.
Reserved_1
Questo campo è riservato e deve essere impostato su NULL.
PipelineInit
Puntatore all'implementazione della funzione EngineAdapterPipelineInit . Questo membro è supportato a partire da Windows 10.
PipelineCleanup
Puntatore all'implementazione della funzione EngineAdapterPipelineCleanup . Questo membro è supportato a partire da Windows 10.
Activate
Puntatore all'implementazione della funzione EngineAdapterActivate . Questo membro è supportato a partire da Windows 10.
Deactivate
Puntatore all'implementazione della funzione EngineAdapterDeactivate . Questo membro è supportato a partire da Windows 10.
QueryExtendedInfo
Puntatore all'implementazione della funzione EngineAdapterQueryExtendedInfo . Questo membro è supportato a partire da Windows 10.
IdentifyAll
Puntatore all'implementazione della funzione EngineAdapterIdentifyAll . Questo membro è supportato a partire da Windows 10.
SetEnrollmentSelector
Puntatore all'implementazione della funzione EngineAdapterSetEnrollmentSelector . Questo membro è supportato a partire da Windows 10.
SetEnrollmentParameters
Puntatore all'implementazione della funzione EngineAdapterSetEnrollmentParameters . Questo membro è supportato a partire da Windows 10.
QueryExtendedEnrollmentStatus
Puntatore all'implementazione della funzione EngineAdapterQueryExtendedEnrollmentStatus . Questo membro è supportato a partire da Windows 10.
RefreshCache
Puntatore all'implementazione della funzione EngineAdapterRefreshCache . Questo membro è supportato a partire da Windows 10.
SelectCalibrationFormat
Puntatore all'implementazione della funzione EngineAdapterSelectCalibrationFormat . Questo membro è supportato a partire da Windows 10.
QueryCalibrationData
Puntatore all'implementazione della funzione EngineAdapterQueryCalibrationData . Questo membro è supportato a partire da Windows 10.
SetAccountPolicy
Puntatore all'implementazione della funzione EngineAdapterSetAccountPolicy . Questo membro è supportato a partire da Windows 10.
CreateKey
Puntatore all'implementazione della funzione EngineAdapterCreateKey . Questo membro è supportato a partire da Windows 10 versione 1607.
IdentifyFeatureSetSecure
Puntatore all'implementazione della funzione EngineAdapterIdentifyFeatureSetSecure . Questo membro è supportato a partire da Windows 10 versione 1607.
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | winbio_adapter.h |