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 方法會將大小 (儲存為位元組的變數地址，) 寫入校正Buffer 的校正數據。 此值不得超過 MaxBufferSize。

如果 EngineAdapterQueryCalibrationData 將此值設定為零，則會捨棄 校正Buffer 的內容，而不會將它們傳送至感測器配接器。 這不是錯誤狀況;它只會指出引擎配接器不需要根據目前的擷取數據來更新感測器的校正。

[in] MaxBufferSize

值，指出 校正Buffer 中引擎配接器可用的位元組) 最大空間 (。

傳回值

如果函式成功，它會 傳回S_OK。 如果函式失敗，它必須傳回下列其中一個 HRESULT 值，以指出錯誤。

備註

EngineAdapterQueryCalibrationData 方法可以分別設定 DiscardAndRepeatCapture 和 CalibrationBufferSize，獨立控制生物特徵辨識服務的重複擷取行為和校正行為。

規格需求