estrutura WINBIO_ENGINE_INTERFACE (winbio_adapter.h)
A estrutura WINBIO_ENGINE_INTERFACE contém ponteiros para as funções personalizadas do adaptador do mecanismo. A Estrutura Biométrica do Windows usa essa estrutura para localizar as funções.
Sintaxe
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;
Membros
Version
Número de versão dessa estrutura.
Windows 10: o número de versão deve ser WINBIO_ENGINE_INTERFACE_VERSION_3 ou WINBIO_ENGINE_INTERFACE_VERSION_4. Para obter mais informações sobre como implementar WINBIO_ENGINE_INTERFACE_VERSION_4, consulte Requisitos de sensor para biometria segura.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012 e Windows 8: o número de versão deve ser WINBIO_ENGINE_INTERFACE_VERSION_2.
Windows Server 2008 R2 e Windows 7: O número de versão deve ser WINBIO_ENGINE_INTERFACE_VERSION_1.
Type
O tipo de adaptador. Isso deve ser WINBIO_ADAPTER_TYPE_ENGINE.
Size
O tamanho, em bytes, dessa estrutura. Defina esse valor como o tamanho da estrutura WINBIO_ENGINE_INTERFACE .
AdapterId
Um GUID que identifica exclusivamente o adaptador do mecanismo. Você deve gerar esse valor.
Attach
Um ponteiro para a implementação da função EngineAdapterAttach .
Detach
Um ponteiro para a implementação da função EngineAdapterDetach .
ClearContext
Um ponteiro para a implementação da função EngineAdapterClearContext .
QueryPreferredFormat
Um ponteiro para a implementação da função EngineAdapterQueryPreferredFormat .
QueryIndexVectorSize
Um ponteiro para a implementação da função EngineAdapterQueryIndexVectorSize .
QueryHashAlgorithms
Um ponteiro para a implementação da função EngineAdapterQueryHashAlgorithms .
SetHashAlgorithm
Um ponteiro para a implementação da função EngineAdapterSetHashAlgorithm .
QuerySampleHint
Um ponteiro para a implementação da função EngineAdapterQuerySampleHint .
AcceptSampleData
Um ponteiro para a implementação da função EngineAdapterAcceptSampleData .
ExportEngineData
Um ponteiro para a implementação da função EngineAdapterExportEngineData .
VerifyFeatureSet
Um ponteiro para a implementação da função EngineAdapterVerifyFeatureSet .
IdentifyFeatureSet
Um ponteiro para a implementação da função EngineAdapterIdentifyFeatureSet .
CreateEnrollment
Um ponteiro para a implementação da função EngineAdapterCreateEnrollment .
UpdateEnrollment
Um ponteiro para a implementação da função EngineAdapterUpdateEnrollment .
GetEnrollmentStatus
Um ponteiro para a implementação da função EngineAdapterGetEnrollmentStatus .
GetEnrollmentHash
Um ponteiro para a implementação da função EngineAdapterGetEnrollmentHash .
CheckForDuplicate
Um ponteiro para a implementação da função EngineAdapterCheckForDuplicate .
CommitEnrollment
Um ponteiro para a implementação da função EngineAdapterCommitEnrollment .
DiscardEnrollment
Um ponteiro para a implementação da função EngineAdapterDiscardEnrollment .
ControlUnit
Um ponteiro para a implementação da função EngineAdapterControlUnit .
ControlUnitPrivileged
Um ponteiro para a implementação da função EngineAdapterControlUnitPrivileged .
NotifyPowerChange
Um ponteiro para a implementação da função EngineAdapterNotifyPowerChange . Esse membro tem suporte a partir de Windows 8.
Reserved_1
Esse campo é reservado e deve ser definido como NULL.
PipelineInit
Um ponteiro para a implementação da função EngineAdapterPipelineInit . Esse membro tem suporte a partir de Windows 10.
PipelineCleanup
Um ponteiro para a implementação da função EngineAdapterPipelineCleanup . Esse membro tem suporte a partir de Windows 10.
Activate
Um ponteiro para a implementação da função EngineAdapterActivate . Esse membro tem suporte a partir de Windows 10.
Deactivate
Um ponteiro para a implementação da função EngineAdapterDeactivate . Esse membro tem suporte a partir de Windows 10.
QueryExtendedInfo
Um ponteiro para a implementação da função EngineAdapterQueryExtendedInfo . Esse membro tem suporte a partir de Windows 10.
IdentifyAll
Um ponteiro para a implementação da função EngineAdapterIdentifyAll . Esse membro tem suporte a partir de Windows 10.
SetEnrollmentSelector
Um ponteiro para a implementação da função EngineAdapterSetEnrollmentSelector . Esse membro tem suporte a partir de Windows 10.
SetEnrollmentParameters
Um ponteiro para a implementação da função EngineAdapterSetEnrollmentParameters . Esse membro tem suporte a partir de Windows 10.
QueryExtendedEnrollmentStatus
Um ponteiro para a implementação da função EngineAdapterQueryExtendedEnrollmentStatus . Esse membro tem suporte a partir de Windows 10.
RefreshCache
Um ponteiro para a implementação da função EngineAdapterRefreshCache . Esse membro tem suporte a partir de Windows 10.
SelectCalibrationFormat
Um ponteiro para a implementação da função EngineAdapterSelectCalibrationFormat . Esse membro tem suporte a partir de Windows 10.
QueryCalibrationData
Um ponteiro para a implementação da função EngineAdapterQueryCalibrationData . Esse membro tem suporte a partir de Windows 10.
SetAccountPolicy
Um ponteiro para a implementação da função EngineAdapterSetAccountPolicy . Esse membro tem suporte a partir de Windows 10.
CreateKey
Um ponteiro para a implementação da função EngineAdapterCreateKey . Esse membro tem suporte a partir do Windows 10, versão 1607.
IdentifyFeatureSetSecure
Um ponteiro para a implementação da função EngineAdapterIdentifyFeatureSetSecure . Esse membro tem suporte a partir do Windows 10, versão 1607.
AcceptPrivateSensorTypeInfo
CreateEnrollmentAuthenticated
IdentifyFeatureSetAuthenticated
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | winbio_adapter.h |