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 値を返します。
リターン コード | 説明 |
---|---|
|
操作が成功しました。 SelectedFormat と MaxBufferSize の両方の戻り値が設定されています。 |
|
エンジン アダプターでは、動的な調整は必要ありません。 これはエラー状態ではありません。 生体認証サービスはこの値を S_OKに変換し、生体認証ユニットは動的調整を使用しないように構成されます。 |
|
エンジン アダプターには動的な調整が必要ですが、 FormatArray パラメーターで指定された調整形式はサポートされていません。 ( FormatCount 引数が 0 の場合は、エンジン アダプターもこのエラー コードを返す必要があります)。このエラー コードにより、生体認証サービスによってエラーがログに記録され、生体認証ユニットの構成が中止されます。 |
|
その他のエラー コードでは、生体認証サービスによってエラーがログに記録され、生体認証ユニットの構成が中止されます。 |
注釈
このメソッドは、生体認証ユニットの構成中に 1 回呼び出されます。 調整形式を選択した後は、変更できません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winbio_adapter.h (Winbio_adapter.h を含む) |