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

エンジン アダプターから一連のキャプチャ後の調整データを取得するために、Windows 生体認証フレームワークによって呼び出されます。

構文

PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN PibioEngineQueryCalibrationDataFn;

HRESULT PibioEngineQueryCalibrationDataFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PBOOLEAN DiscardAndRepeatCapture,
  [out]     PUCHAR CalibrationBuffer,
  [out]     PSIZE_T CalibrationBufferSize,
  [in]      SIZE_T MaxBufferSize
)
{...}

パラメーター

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

EngineAdapterQueryCalibrationData メソッドで設定する必要があるブール値のアドレス。 この値は、調整が完了した後に現在のサンプルで生体認証サービスが行う必要があることを示します。

• TRUE は 、キャプチャされた生体認証サンプルが使用不可であることを示します。 生体認証サービスはサンプルを破棄し、新しいサンプルを収集します。
• FALSE は 、サンプルが使用可能であることを示し、エンジンに対してさらに操作を実行するように指示する必要があります。

[out] CalibrationBuffer

メソッドが調整データを書き込む必要がある空のバッファーのアドレス。 このバッファーを保持するメモリは生体認証サービスに属しており、 EngineAdapterQueryCalibrationData メソッドが返された後は、エンジン アダプターはこのバッファーへのポインターを保持しないようにする必要があります。

[out] CalibrationBufferSize

EngineAdapterQueryCalibrationData メソッドが CalibrationBuffer に書き込んだ調整データのサイズ (バイト単位) を格納する変数のアドレス。 この値は MaxBufferSize を超えることはできません。

EngineAdapterQueryCalibrationData がこの値を 0 に設定すると、CalibrationBuffer の内容は、センサー アダプターに送信されずに破棄されます。 これはエラー条件ではありません。これは、エンジン アダプターが現在のキャプチャ データに基づいてセンサーの調整を更新する必要がないことを示すだけです。

[in] MaxBufferSize

CalibrationBuffer のエンジン アダプターで使用できる最大領域 (バイト単位) を示す値。

戻り値

関数が成功した場合は、S_OK を返します。 関数が失敗した場合は、エラーを示すために次のいずれかの HRESULT 値を返す必要があります。

リターン コード	説明
E_some_error	エラー コードが発生すると、生体認証サービスは動的調整ループを中止し、キャプチャ操作を中止します。

注釈

EngineAdapterQueryCalibrationData メソッドは、それぞれ DiscardAndRepeatCapture と CalibrationBufferSize を設定することで、生体認証サービスの繰り返しキャプチャ動作と調整動作を個別に制御できます。

必要な動作	DiscardAndRepeatCapture	CalibrationBufferSize
調整後にキャプチャを繰り返します。	TRUE	0 以外
調整なしでキャプチャを繰り返します。	TRUE	ゼロ
校正後もサンプルの処理を続けます。	FALSE	0 以外
校正なしでサンプルの処理を続行します。	FALSE	ゼロ

要件

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