共用方式為

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 值。

傳回碼 Description
S_OK
作業成功。 SelectedFormat 和 MaxBufferSize 傳回值都已設定。
E_NOTIMPL
引擎配接器不需要動態校正。 這不是錯誤狀況。 生物特徵辨識服務會將此值轉換成 S_OK，而且生物特徵辨識單位將會設定為不使用動態校正。
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
引擎配接器需要動態校正，但不支援 FormatArray 參數中指定的任何校正格式。 (如果 FormatCount 自變數為零，引擎配接器也應該傳回此錯誤碼。) 此錯誤碼會導致生物特徵辨識服務記錄錯誤並中止生物特徵辨識單位的設定。
E_some_other_error
任何其他錯誤碼都會造成生物特徵辨識服務記錄錯誤，並中止生物特徵辨識單位的設定。

備註

這個方法會在生物特徵辨識單位的設定期間呼叫一次。 選取校正格式之後，就無法變更。

規格需求

需求 值
最低支援的用戶端 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbio_adapter.h (包含 Winbio_adapter.h)