WINBIO_ENGINE_INTERFACE structure (winbio_adapter.h)
La structure WINBIO_ENGINE_INTERFACE contient des pointeurs vers vos fonctions d’adaptateur de moteur personnalisées. L’infrastructure biométrique Windows utilise cette structure pour localiser les fonctions.
Syntaxe
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;
Membres
Version
Numéro de version de cette structure.
Windows 10 : le numéro de version doit être WINBIO_ENGINE_INTERFACE_VERSION_3 ou WINBIO_ENGINE_INTERFACE_VERSION_4. Pour plus d’informations sur l’implémentation de WINBIO_ENGINE_INTERFACE_VERSION_4, consultez Configuration requise des capteurs pour la biométrie sécurisée.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012 et Windows 8 : le numéro de version doit être WINBIO_ENGINE_INTERFACE_VERSION_2.
Windows Server 2008 R2 et Windows 7 : Le numéro de version doit être WINBIO_ENGINE_INTERFACE_VERSION_1.
Type
Type d’adaptateur. Cela doit être WINBIO_ADAPTER_TYPE_ENGINE.
Size
Taille, en octets, de cette structure. Définissez cette valeur sur la taille de la structure WINBIO_ENGINE_INTERFACE .
AdapterId
GUID qui identifie de manière unique l’adaptateur du moteur. Vous devez générer cette valeur.
Attach
Pointeur vers votre implémentation de la fonction EngineAdapterAttach .
Detach
Pointeur vers votre implémentation de la fonction EngineAdapterDetach .
ClearContext
Pointeur vers votre implémentation de la fonction EngineAdapterClearContext .
QueryPreferredFormat
Pointeur vers votre implémentation de la fonction EngineAdapterQueryPreferredFormat .
QueryIndexVectorSize
Pointeur vers votre implémentation de la fonction EngineAdapterQueryIndexVectorSize .
QueryHashAlgorithms
Pointeur vers votre implémentation de la fonction EngineAdapterQueryHashAlgorithms .
SetHashAlgorithm
Pointeur vers votre implémentation de la fonction EngineAdapterSetHashAlgorithm .
QuerySampleHint
Pointeur vers votre implémentation de la fonction EngineAdapterQuerySampleHint .
AcceptSampleData
Pointeur vers votre implémentation de la fonction EngineAdapterAcceptSampleData .
ExportEngineData
Pointeur vers votre implémentation de la fonction EngineAdapterExportEngineData .
VerifyFeatureSet
Pointeur vers votre implémentation de la fonction EngineAdapterVerifyFeatureSet .
IdentifyFeatureSet
Pointeur vers votre implémentation de la fonction EngineAdapterIdentifyFeatureSet .
CreateEnrollment
Pointeur vers votre implémentation de la fonction EngineAdapterCreateEnrollment .
UpdateEnrollment
Pointeur vers votre implémentation de la fonction EngineAdapterUpdateEnrollment .
GetEnrollmentStatus
Pointeur vers votre implémentation de la fonction EngineAdapterGetEnrollmentStatus .
GetEnrollmentHash
Pointeur vers votre implémentation de la fonction EngineAdapterGetEnrollmentHash .
CheckForDuplicate
Pointeur vers votre implémentation de la fonction EngineAdapterCheckForDuplicate .
CommitEnrollment
Pointeur vers votre implémentation de la fonction EngineAdapterCommitEnrollment .
DiscardEnrollment
Pointeur vers votre implémentation de la fonction EngineAdapterDiscardEnrollment .
ControlUnit
Pointeur vers votre implémentation de la fonction EngineAdapterControlUnit .
ControlUnitPrivileged
Pointeur vers votre implémentation de la fonction EngineAdapterControlUnitPrivileged .
NotifyPowerChange
Pointeur vers votre implémentation de la fonction EngineAdapterNotifyPowerChange . Ce membre est pris en charge à partir de Windows 8.
Reserved_1
Ce champ est réservé et doit être défini sur NULL.
PipelineInit
Pointeur vers votre implémentation de la fonction EngineAdapterPipelineInit . Ce membre est pris en charge à partir de Windows 10.
PipelineCleanup
Pointeur vers votre implémentation de la fonction EngineAdapterPipelineCleanup . Ce membre est pris en charge à partir de Windows 10.
Activate
Pointeur vers votre implémentation de la fonction EngineAdapterActivate . Ce membre est pris en charge à partir de Windows 10.
Deactivate
Pointeur vers votre implémentation de la fonction EngineAdapterDeactivate . Ce membre est pris en charge à partir de Windows 10.
QueryExtendedInfo
Pointeur vers votre implémentation de la fonction EngineAdapterQueryExtendedInfo . Ce membre est pris en charge à partir de Windows 10.
IdentifyAll
Pointeur vers votre implémentation de la fonction EngineAdapterIdentifyAll . Ce membre est pris en charge à partir de Windows 10.
SetEnrollmentSelector
Pointeur vers votre implémentation de la fonction EngineAdapterSetEnrollmentSelector . Ce membre est pris en charge à partir de Windows 10.
SetEnrollmentParameters
Pointeur vers votre implémentation de la fonction EngineAdapterSetEnrollmentParameters . Ce membre est pris en charge à partir de Windows 10.
QueryExtendedEnrollmentStatus
Pointeur vers votre implémentation de la fonction EngineAdapterQueryExtendedEnrollmentStatus . Ce membre est pris en charge à partir de Windows 10.
RefreshCache
Pointeur vers votre implémentation de la fonction EngineAdapterRefreshCache . Ce membre est pris en charge à partir de Windows 10.
SelectCalibrationFormat
Pointeur vers votre implémentation de la fonction EngineAdapterSelectCalibrationFormat . Ce membre est pris en charge à partir de Windows 10.
QueryCalibrationData
Pointeur vers votre implémentation de la fonction EngineAdapterQueryCalibrationData . Ce membre est pris en charge à partir de Windows 10.
SetAccountPolicy
Pointeur vers votre implémentation de la fonction EngineAdapterSetAccountPolicy . Ce membre est pris en charge à partir de Windows 10.
CreateKey
Pointeur vers votre implémentation de la fonction EngineAdapterCreateKey . Ce membre est pris en charge à partir de Windows 10, version 1607.
IdentifyFeatureSetSecure
Pointeur vers votre implémentation de la fonction EngineAdapterIdentifyFeatureSetSecure . Ce membre est pris en charge à partir de Windows 10, version 1607.
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | winbio_adapter.h |