fungsi panggilan balik PIBIO_ENGINE_IDENTIFY_ALL_FN (winbio_adapter.h)

Artikel
08/27/2023

Dipanggil oleh Windows Biometric Framework untuk menentukan identitas setiap orang yang saat ini berada dalam bingkai kamera.

Sintaks

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

Parameter

[in, out] Pipeline

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

[out] PresenceCount

Alamat variabel yang menerima jumlah kehadiran yang terdeteksi oleh fungsi.

[out] PresenceArray

Alamat variabel yang menerima pointer ke array elemen WINBIO_PRESENCE .

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 mencatat kesalahan dan mengabaikan bingkai kamera.

Keterangan

Layanan biometrik memanggil metode ini setelah mengirim bingkai data baru ke adaptor mesin.

Setelah memproses bingkai data, fungsi ini harus mengembalikan satu elemen WINBIO_PRESENCE untuk setiap kehadiran yang terdeteksi dalam bingkai data.

Jika fungsi EngineAdapterIdentifyAll tidak dapat menemukan wajah apa pun dalam bingkai, fungsi ini mengembalikan HRESULTS_OK dan mengatur parameter pengembalian PresenceCount dan PresenceArray masing-masing ke nol dan NULL. Dengan kata lain, bingkai yang tidak berisi kehadiran manusia bukanlah kondisi kesalahan.

Satu-satunya waktu EngineAdapterIdentifyAll harus mengembalikan HRESULT selain S_OK adalah jika tidak ingin layanan bio menggunakan bingkai untuk memperbarui status Presence Monitor. Ini harus menjadi kejadian yang jarang terjadi. Adaptor mesin bertanggung jawab untuk mengalokasikan array elemen WINBIO_PRESENCE yang dikembalikannya dalam parameter PresenceArray . Ini harus mengalokasikan memori ini dari tumpukan proses dengan menggunakan fungsi HeapAlloc . Setelah array dibuat, array menjadi properti Windows Biometric Framework. Karena Framework membatalkan alokasi memori ini setelah menggunakannya, adaptor mesin Anda tidak boleh mencoba membatalkan alokasi array atau menyimpan pointer ke dalamnya. Kegagalan untuk mengikuti aturan ini akan menyebabkan kerusakan timbunan dan kemungkinan crash layanan biometrik.

Nilai item WINBIO_PRESENCE individu di PresenceArray akan menentukan peristiwa yang dihasilkan untuk aplikasi klien. Lihat diskusi tentang struktur WINBIO_PRESENCE untuk detailnya.

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