fungsi panggilan balik PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN (winbio_adapter.h)

Artikel
08/27/2023

Dipanggil oleh Windows Biometric Framework untuk mendapatkan sekumpulan data kalibrasi pasca-tangkapan dari adaptor mesin.

Sintaks

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
)
{...}

Parameter

[in, out] Pipeline

Arahkan ke struktur WINBIO_PIPELINE yang terkait dengan unit biometrik yang melakukan operasi.

[out] DiscardAndRepeatCapture

Alamat nilai Boolean yang harus ditetapkan oleh metode EngineAdapterQueryCalibrationData . Nilai ini menunjukkan apa yang harus dilakukan layanan biometrik dengan sampel saat ini setelah kalibrasi selesai.

TRUE menunjukkan bahwa sampel biometrik yang diambil tidak dapat digunakan. Layanan biometrik akan membuang sampel dan mengumpulkan yang baru.
FALSE menunjukkan bahwa sampel dapat digunakan dan Mesin harus diinstruksikan untuk melakukan operasi lebih lanjut di atasnya.

[out] CalibrationBuffer

Alamat buffer kosong di mana metode diharapkan untuk menulis data kalibrasinya. Memori yang memegang buffer ini milik layanan biometrik, dan Adaptor Mesin tidak boleh menyimpan pointer apa pun ke buffer ini setelah metode EngineAdapterQueryCalibrationData kembali.

[out] CalibrationBufferSize

Alamat variabel tempat metode EngineAdapterQueryCalibrationData akan menyimpan ukuran (dalam byte) dari data kalibrasi yang telah ditulisnya ke CalibrationBuffer. Nilai ini tidak boleh melebihi MaxBufferSize.

Jika EngineAdapterQueryCalibrationData menetapkan nilai ini ke nol, konten CalibrationBuffer akan dibuang tanpa mengirimkannya ke Adaptor Sensor. Ini bukan kondisi kesalahan; ini hanya menunjukkan bahwa Adaptor Mesin tidak perlu memperbarui kalibrasi sensor berdasarkan data tangkapan saat ini.

[in] MaxBufferSize

Nilai yang menunjukkan ruang maksimum (dalam byte) yang tersedia untuk Adaptor Mesin di CalibrationBuffer.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika fungsi gagal, fungsi harus mengembalikan salah satu nilai HRESULT berikut untuk menunjukkan kesalahan.

Menampilkan kode	Deskripsi
E_some_error	Kode kesalahan apa pun akan menyebabkan Layanan Biometrik menghentikan perulangan kalibrasi dinamis dan membatalkan operasi penangkapan.

Keterangan

Metode EngineAdapterQueryCalibrationData dapat mengontrol perilaku penangkapan berulang layanan biometrik secara independen dan perilaku kalibrasi dengan mengatur DiscardAndRepeatCapture dan CalibrationBufferSize.

Perilaku yang Diinginkan	DiscardAndRepeatCapture	CalibrationBufferSize
Ulangi pengambilan setelah kalibrasi.	TRUE	Bukan nol
Ulangi pengambilan tanpa kalibrasi.	TRUE	Nol
Lanjutkan memproses sampel setelah kalibrasi.	FALSE	Bukan nol
Lanjutkan pemrosesan sampel tanpa kalibrasi.	FALSE	Nol

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbio_adapter.h (termasuk Winbio_adapter.h)

Bagikan melalui