WINBIO_ENGINE_INTERFACE 構造体 (winbio_adapter.h)

[アーティクル]
08/27/2023

WINBIO_ENGINE_INTERFACE構造体には、カスタムエンジンアダプター関数へのポインターが含まれています。 Windows 生体認証フレームワークでは、この構造を使用して関数を検索します。

構文

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;

メンバー

Version

この構造体のバージョン番号。

Windows 10: バージョン番号は、WINBIO_ENGINE_INTERFACE_VERSION_3またはWINBIO_ENGINE_INTERFACE_VERSION_4する必要があります。 WINBIO_ENGINE_INTERFACE_VERSION_4の実装の詳細については、「セキュリティで保護された生体認証のセンサー要件」を参照してください。

Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8: バージョン番号をWINBIO_ENGINE_INTERFACE_VERSION_2する必要があります。

Windows Server 2008 R2 と Windows 7: バージョン番号は WINBIO_ENGINE_INTERFACE_VERSION_1する必要があります。

Type

アダプターの種類。これは WINBIO_ADAPTER_TYPE_ENGINEする必要があります。

Size

この構造体のサイズ (バイト単位)。この値を 、WINBIO_ENGINE_INTERFACE 構造体のサイズに設定します。

AdapterId

エンジンアダプターを一意に識別する GUID。この値を生成する必要があります。

Attach

EngineAdapterAttach 関数の実装へのポインター。

Detach

EngineAdapterDetach 関数の実装へのポインター。

ClearContext

EngineAdapterClearContext 関数の実装へのポインター。

QueryPreferredFormat

EngineAdapterQueryPreferredFormat 関数の実装へのポインター。

QueryIndexVectorSize

EngineAdapterQueryIndexVectorSize 関数の実装へのポインター。

QueryHashAlgorithms

EngineAdapterQueryHashAlgorithms 関数の実装へのポインター。

SetHashAlgorithm

EngineAdapterSetHashAlgorithm 関数の実装へのポインター。

QuerySampleHint

EngineAdapterQuerySampleHint 関数の実装へのポインター。

AcceptSampleData

EngineAdapterAcceptSampleData 関数の実装へのポインター。

ExportEngineData

EngineAdapterExportEngineData 関数の実装へのポインター。

VerifyFeatureSet

EngineAdapterVerifyFeatureSet 関数の実装へのポインター。

IdentifyFeatureSet

EngineAdapterIdentifyFeatureSet 関数の実装へのポインター。

CreateEnrollment

EngineAdapterCreateEnrollment 関数の実装へのポインター。

UpdateEnrollment

EngineAdapterUpdateEnrollment 関数の実装へのポインター。

GetEnrollmentStatus

EngineAdapterGetEnrollmentStatus 関数の実装へのポインター。

GetEnrollmentHash

EngineAdapterGetEnrollmentHash 関数の実装へのポインター。

CheckForDuplicate

EngineAdapterCheckForDuplicate 関数の実装へのポインター。

CommitEnrollment

EngineAdapterCommitEnrollment 関数の実装へのポインター。

DiscardEnrollment

EngineAdapterDiscardEnrollment 関数の実装へのポインター。

ControlUnit

EngineAdapterControlUnit 関数の実装へのポインター。

ControlUnitPrivileged

EngineAdapterControlUnitPrivileged 関数の実装へのポインター。

NotifyPowerChange

EngineAdapterNotifyPowerChange 関数の実装へのポインター。このメンバーは、Windows 8 以降でサポートされています。

Reserved_1

このフィールドは予約されており、 NULL に設定する必要があります。

PipelineInit

EngineAdapterPipelineInit 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

PipelineCleanup

EngineAdapterPipelineCleanup 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

Activate

EngineAdapterActivate 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

Deactivate

EngineAdapterDeactivate 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

QueryExtendedInfo

EngineAdapterQueryExtendedInfo 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

IdentifyAll

EngineAdapterIdentifyAll 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

SetEnrollmentSelector

EngineAdapterSetEnrollmentSelector 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

SetEnrollmentParameters

EngineAdapterSetEnrollmentParameters 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

QueryExtendedEnrollmentStatus

EngineAdapterQueryExtendedEnrollmentStatus 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

RefreshCache

EngineAdapterRefreshCache 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

SelectCalibrationFormat

EngineAdapterSelectCalibrationFormat 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

QueryCalibrationData

EngineAdapterQueryCalibrationData 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

SetAccountPolicy

EngineAdapterSetAccountPolicy 関数の実装へのポインター。このメンバーは、Windows 10 以降でサポートされています。

CreateKey

EngineAdapterCreateKey 関数の実装へのポインター。このメンバーは、Windows 10 バージョン 1607 以降でサポートされています。

IdentifyFeatureSetSecure

EngineAdapterIdentifyFeatureSetSecure 関数の実装へのポインター。このメンバーは、Windows 10 バージョン 1607 以降でサポートされています。

AcceptPrivateSensorTypeInfo

CreateEnrollmentAuthenticated

IdentifyFeatureSetAuthenticated

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	winbio_adapter.h

こちらもご覧ください

プラグイン関数

プラグイン構造

WbioQueryEngineInterface

次の方法で共有

WINBIO_ENGINE_INTERFACE 構造体 (winbio_adapter.h)

構文

メンバー

要件

こちらもご覧ください

フィードバック

その他のリソース