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

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

構文

PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN PibioSensorQueryCalibrationFormatsFn;

HRESULT PibioSensorQueryCalibrationFormatsFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatArraySize,
  [out]     PSIZE_T FormatCount
)
{...}

パラメーター

[in, out] Pipeline

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

[out] FormatArray

空の WINBIO_UUID 項目の配列のアドレス。 SensorAdapterQueryCalibrationFormats メソッドは、センサー アダプターに認識されている調整データ形式を識別する 1 つ以上の UUID でこの配列を埋める必要があります。

[in] FormatArraySize

FormatArray で使用できるスロットの数を示す値。 SensorAdapterQueryCalibrationFormats メソッドは、この数を超える要素を FormatArray に書き込もうとしないでください。または、結果が予測不可能になります。

[out] FormatCount

FormatArray で返される UUID の数を受け取る変数へのポインター。 SensorAdapterQueryCalibrationFormats メソッドは、 を返す前にこの値を設定する必要があります。

戻り値

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

リターン コード	説明
E_notimpl	– センサー アダプターは動的調整をサポートしていません。
E_some_other_error	その他のエラー コードでは、Windows 生体認証フレームワークによってエラーがログに記録され、生体認証ユニットの構成が中止されます。

注釈

このメソッドは、生体認証ユニットの初期構成中に 1 回呼び出されます。

センサー アダプターでサポートされている各調整形式は、個別の UUID 値によって識別されます。

このメソッドは、任意の RPC サーバー スレッドのコンテキストで実行されます。

センサー アダプターが動的調整をサポートしていない場合は、 E_NOTIMPL の値を返す必要があります。 エンジン アダプターで動的な調整が必要な場合を除き、Windows 生体認証フレームワークはこれをエラーとして扱いません。 (詳細については、 EngineAdapterSelectCalibrationFormat メソッドの説明を参照してください)。

このメソッドが S_OK の値を返す場合は、 FormatArray と FormatCount を 設定する必要があります。 このメソッドが FormatCount の値と共にS_OKを返すのはエラーです。 これにより、Windows 生体認証フレームワークによって WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY エラー メッセージがログに記録され、生体認証ユニットの構成が中止されます。

要件

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