ホーム › Devices.BiometricFramework › PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN(
    WINBIO_PIPELINE* Pipeline,
    GUID* FormatArray,
    UINT_PTR FormatCount,
    GUID* SelectedFormat,
    UINT_PTR* MaxBufferSize
);

パラメーター

フィールド	型	説明
Pipeline	WINBIO_PIPELINE*	操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインターです。
FormatArray	GUID*	Sensor Adapter がサポートする校正データフォーマットを識別する WINBIO_UUID 項目の配列のアドレスです。Engine Adapter は、これらのフォーマットのいずれかを自身の校正データ用に選択することが求められます。
FormatCount	UINT_PTR	FormatArray パラメーター内の UUID の数を示す値です。
SelectedFormat	GUID*	EngineAdapterSelectCalibrationFormat メソッドが、選択した校正フォーマットの UUID を格納する WINBIO_UUID 項目のアドレスです。これは FormatArray パラメーター内の UUID のいずれかでなければなりません。
MaxBufferSize	UINT_PTR*	EngineAdapterSelectCalibrationFormat メソッドが、Sensor Adapter に返す予定の校正データの最大サイズ (バイト単位) を格納する変数のアドレスです。このバッファーの最大サイズは 4096 バイト以下でなければなりません。

公式ドキュメント

Engine Adapter が Sensor Adapter のどの校正フォーマットを使用するかを判断するために、Windows Biometric Framework から呼び出されます。

戻り値

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

戻り値	説明
S_OK	操作は成功しました。SelectedFormat と MaxBufferSize の両方の戻り値が設定されています。
E_NOTIMPL	Engine Adapter は動的な校正を必要としません。これはエラー状態ではありません。Biometric Service はこの値を S_OK に変換し、バイオメトリックユニットは動的な校正を使用しないように構成されます。
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	Engine Adapter は動的な校正を必要としますが、FormatArray パラメーターで指定された校正フォーマットをいずれもサポートしていません。(FormatCount 引数が 0 の場合も、Engine Adapter はこのエラーコードを返す必要があります。) このエラーコードが返されると、Biometric Service はエラーをログに記録し、バイオメトリックユニットの構成を中止します。
E_some_other_error	その他のエラーコードが返された場合、Biometric Service はエラーをログに記録し、バイオメトリックユニットの構成を中止します。

解説(Remarks)

このメソッドは、バイオメトリックユニットの構成中に 1 回だけ呼び出されます。校正フォーマットがいったん選択されると、変更することはできません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)