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 |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour