estructura de WINBIO_ENGINE_INTERFACE (winbio_adapter.h)
La estructura WINBIO_ENGINE_INTERFACE contiene punteros a las funciones del adaptador del motor personalizado. Windows Biometric Framework usa esta estructura para localizar las funciones.
Sintaxis
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;
Miembros
Version
Número de versión de esta estructura.
Windows 10: el número de versión debe ser WINBIO_ENGINE_INTERFACE_VERSION_3 o WINBIO_ENGINE_INTERFACE_VERSION_4. Para más información sobre la implementación de WINBIO_ENGINE_INTERFACE_VERSION_4, consulte Requisitos del sensor para la biometría segura.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y Windows 8: el número de versión debe ser WINBIO_ENGINE_INTERFACE_VERSION_2.
Windows Server 2008 R2 y Windows 7: El número de versión debe ser WINBIO_ENGINE_INTERFACE_VERSION_1.
Type
Tipo de adaptador. Debe ser WINBIO_ADAPTER_TYPE_ENGINE.
Size
Tamaño, en bytes, de esta estructura. Establezca este valor en el tamaño de la estructura WINBIO_ENGINE_INTERFACE .
AdapterId
GUID que identifica de forma única el adaptador del motor. Debe generar este valor.
Attach
Puntero a la implementación de la función EngineAdapterAttach .
Detach
Puntero a la implementación de la función EngineAdapterDetach .
ClearContext
Puntero a la implementación de la función EngineAdapterClearContext .
QueryPreferredFormat
Puntero a la implementación de la función EngineAdapterQueryPreferredFormat .
QueryIndexVectorSize
Puntero a la implementación de la función EngineAdapterQueryIndexVectorSize .
QueryHashAlgorithms
Puntero a la implementación de la función EngineAdapterQueryHashAlgorithms .
SetHashAlgorithm
Puntero a la implementación de la función EngineAdapterSetHashAlgorithm .
QuerySampleHint
Puntero a la implementación de la función EngineAdapterQuerySampleHint .
AcceptSampleData
Puntero a la implementación de la función EngineAdapterAcceptSampleData .
ExportEngineData
Puntero a la implementación de la función EngineAdapterExportEngineData .
VerifyFeatureSet
Puntero a la implementación de la función EngineAdapterVerifyFeatureSet .
IdentifyFeatureSet
Puntero a la implementación de la función EngineAdapterIdentifyFeatureSet .
CreateEnrollment
Puntero a la implementación de la función EngineAdapterCreateEnrollment .
UpdateEnrollment
Puntero a la implementación de la función EngineAdapterUpdateEnrollment .
GetEnrollmentStatus
Puntero a la implementación de la función EngineAdapterGetEnrollmentStatus .
GetEnrollmentHash
Puntero a la implementación de la función EngineAdapterGetEnrollmentHash .
CheckForDuplicate
Puntero a la implementación de la función EngineAdapterCheckForDuplicate .
CommitEnrollment
Puntero a la implementación de la función EngineAdapterCommitEnrollment .
DiscardEnrollment
Puntero a la implementación de la función EngineAdapterDiscardEnrollment .
ControlUnit
Puntero a la implementación de la función EngineAdapterControlUnit .
ControlUnitPrivileged
Puntero a la implementación de la función EngineAdapterControlUnitPrivileged .
NotifyPowerChange
Puntero a la implementación de la función EngineAdapterNotifyPowerChange . Este miembro se admite a partir de Windows 8.
Reserved_1
Este campo está reservado y debe establecerse en NULL.
PipelineInit
Puntero a la implementación de la función EngineAdapterPipelineInit . Este miembro se admite a partir de Windows 10.
PipelineCleanup
Puntero a la implementación de la función EngineAdapterPipelineCleanup . Este miembro se admite a partir de Windows 10.
Activate
Puntero a la implementación de la función EngineAdapterActivate . Este miembro se admite a partir de Windows 10.
Deactivate
Puntero a la implementación de la función EngineAdapterDeactivate . Este miembro se admite a partir de Windows 10.
QueryExtendedInfo
Puntero a la implementación de la función EngineAdapterQueryExtendedInfo . Este miembro se admite a partir de Windows 10.
IdentifyAll
Puntero a la implementación de la función EngineAdapterIdentifyAll . Este miembro se admite a partir de Windows 10.
SetEnrollmentSelector
Puntero a la implementación de la función EngineAdapterSetEnrollmentSelector . Este miembro se admite a partir de Windows 10.
SetEnrollmentParameters
Puntero a la implementación de la función EngineAdapterSetEnrollmentParameters . Este miembro se admite a partir de Windows 10.
QueryExtendedEnrollmentStatus
Puntero a la implementación de la función EngineAdapterQueryExtendedEnrollmentStatus . Este miembro se admite a partir de Windows 10.
RefreshCache
Puntero a la implementación de la función EngineAdapterRefreshCache . Este miembro se admite a partir de Windows 10.
SelectCalibrationFormat
Puntero a la implementación de la función EngineAdapterSelectCalibrationFormat . Este miembro se admite a partir de Windows 10.
QueryCalibrationData
Puntero a la implementación de la función EngineAdapterQueryCalibrationData . Este miembro se admite a partir de Windows 10.
SetAccountPolicy
Puntero a la implementación de la función EngineAdapterSetAccountPolicy . Este miembro se admite a partir de Windows 10.
CreateKey
Puntero a la implementación de la función EngineAdapterCreateKey . Este miembro se admite a partir de Windows 10, versión 1607.
IdentifyFeatureSetSecure
Puntero a la implementación de la función EngineAdapterIdentifyFeatureSetSecure . Este miembro se admite a partir de Windows 10, versión 1607.
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | winbio_adapter.h |