fungsi panggilan balik PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN (winbio_adapter.h)

Artikel
03/03/2024

Dipanggil oleh Windows Biometric Framework untuk menentukan format kalibrasi Adaptor Sensor mana yang ingin digunakan Adaptor Mesin.

Sintaks

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

Parameter

[in, out] Pipeline

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

[in] FormatArray

Alamat array item WINBIO_UUID yang mengidentifikasi format data kalibrasi yang didukung oleh Adaptor Sensor. Adaptor Mesin diharapkan memilih salah satu format ini untuk data kalibrasinya.

[in] FormatCount

Nilai yang menunjukkan jumlah UUID dalam parameter FormatArray .

[out] SelectedFormat

Alamat item WINBIO_UUID di mana metode EngineAdapterSelectCalibrationFormat akan menyimpan UUID dari format kalibrasi yang dipilih. Ini harus menjadi salah satu UUID dalam parameter FormatArray .

[out] MaxBufferSize

Alamat variabel tempat metode EngineAdapterSelectCalibrationFormat akan menyimpan ukuran maksimum (dalam byte) dari data kalibrasi apa pun yang rencananya akan dikembalikan ke Adaptor Sensor. Ukuran maksimum buffer ini harus 4096 byte atau kurang.

Mengembalikan nilai

Fungsi ini akan mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil. Nilai pengembalian SelectedFormat dan MaxBufferSize keduanya telah diatur.
E_NOTIMPL	Adaptor Mesin tidak memerlukan kalibrasi dinamis. Ini bukan kondisi kesalahan. Layanan Biometrik akan mengonversi nilai ini menjadi S_OK, dan unit biometrik akan dikonfigurasi untuk tidak menggunakan kalibrasi dinamis.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	Adaptor Mesin memerlukan kalibrasi dinamis, tetapi tidak mendukung format kalibrasi apa pun yang ditentukan dalam parameter FormatArray . (Adapter Mesin juga harus mengembalikan kode kesalahan ini jika argumen FormatCount adalah nol.) Kode kesalahan ini akan menyebabkan Layanan Biometrik mencatat kesalahan dan membatalkan konfigurasi unit biometrik.
E_some_other_error	Kode kesalahan lainnya akan menyebabkan Layanan Biometrik mencatat kesalahan dan membatalkan konfigurasi unit biometrik.

Keterangan

Metode ini dipanggil sekali selama konfigurasi unit biometrik. Setelah format kalibrasi dipilih, format tidak dapat diubah.

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