PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN コールバック関数 (winbio_adapter.h)

エンジン アダプターが使用するセンサー アダプターの調整形式を決定するために、Windows 生体認証フレームワークによって呼び出されます。

構文

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN PibioEngineSelectCalibrationFormatFn;

HRESULT PibioEngineSelectCalibrationFormatFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatCount,
  [out]     PWINBIO_UUID SelectedFormat,
  [out]     PSIZE_T MaxBufferSize
)
{...}

パラメーター

[in, out] Pipeline

操作を実行する生体認証ユニットに関連付けられている WINBIO_PIPELINE 構造体へのポインター。

[in] FormatArray

センサー アダプターでサポートされている調整データ形式を識別する WINBIO_UUID 項目の配列のアドレス。 エンジン アダプターでは、調整データにこれらの形式のいずれかを選択する必要があります。

[in] FormatCount

FormatArray パラメーターの UUID の数を示す値。

[out] SelectedFormat

EngineAdapterSelectCalibrationFormat メソッドが選択した調整形式の UUID を格納するWINBIO_UUID項目のアドレス。 これは FormatArray パラメーターの UUID のいずれかである必要があります。

[out] MaxBufferSize

EngineAdapterSelectCalibrationFormat メソッドがセンサー アダプターに返す予定の調整データの最大サイズ (バイト単位) を格納する変数のアドレス。 このバッファーの最大サイズは 4096 バイト以下である必要があります。

戻り値

関数は、次のいずれかの HRESULT 値を返します。

リターン コード	説明
S_ok	操作が成功しました。 SelectedFormat と MaxBufferSize の両方の戻り値が設定されています。
E_notimpl	エンジン アダプターでは、動的な調整は必要ありません。 これはエラー状態ではありません。 生体認証サービスはこの値を S_OKに変換し、生体認証ユニットは動的調整を使用しないように構成されます。
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	エンジン アダプターには動的な調整が必要ですが、 FormatArray パラメーターで指定された調整形式はサポートされていません。 ( FormatCount 引数が 0 の場合は、エンジン アダプターもこのエラー コードを返す必要があります)。このエラー コードにより、生体認証サービスによってエラーがログに記録され、生体認証ユニットの構成が中止されます。
E_some_other_error	その他のエラー コードでは、生体認証サービスによってエラーがログに記録され、生体認証ユニットの構成が中止されます。

注釈

このメソッドは、生体認証ユニットの構成中に 1 回呼び出されます。 調整形式を選択した後は、変更できません。

要件

要件	値
サポートされている最小のクライアント	Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winbio_adapter.h (Winbio_adapter.h を含む)