struktur WINBIO_PRESENCE
Berisi informasi tentang keberadaan individu yang kehadirannya sedang dipantau.
Sintaks
typedef struct _WINBIO_PRESENCE {
WINBIO_BIOMETRIC_TYPE Factor;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
HRESULT Status;
WINBIO_REJECT_DETAIL RejectDetail;
WINBIO_IDENTITY Identity;
ULONGLONG TrackingId;
WINBIO_PROTECTION_TICKET Ticket;
WINBIO_PRESENCE_PROPERTIES Properties;
} WINBIO_PRESENCE, *PWINBIO_PRESENCE;
Anggota
-
Faktor
-
Faktor biometrik yang digunakan untuk memantau keberadaan individu.
-
SubFaktor
-
Kualifikasi subfaktor biometrik untuk faktor biometrik yang digunakan untuk memantau keberadaan individu.
-
Keadaan
-
Status prosedur identifikasi untuk individu.
-
RejectDetail
-
Informasi tambahan tentang kegagalan mengenali individu, termasuk umpan balik yang menjelaskan cara memperbaiki kegagalan.
-
Identitas
-
Identitas individu yang kehadirannya sedang dipantau, setelah individu tersebut diidentifikasi.
-
TrackingId
-
Bilangan bulat yang dihasilkan oleh adaptor dan secara unik mengidentifikasi individu. Pengidentifikasi pelacakan yang ditetapkan adaptor ke individu tertentu dijamin konstan selama orang tersebut tetap berada di bingkai kamera.
-
Tiket
-
Dicadangkan. Atur ke 0 oleh adaptor.
-
Properti
-
Informasi khusus faktor tentang posisi individu.
Keterangan
Fungsi EngineAdapterIdentifyAll membuat array struktur WINBIO_PRESENCE dan mengirim array ini ke layanan biometrik. Layanan biometrik menggunakan array untuk memperbarui model internal manusia di dekat komputer.
Tergantung pada hasil pembaruan ini, layanan biometrik dapat menghasilkan struktur WINBIO_ASYNC_RESULT untuk fungsi WinBioMonitorPresence untuk klien mana pun dengan monitor kehadiran aktif. WINBIO_ASYNC_RESULT . Anggota operasi struktur berisi WINBIO_OPERATION_MONITOR_PRESENCE, dan WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType memberikan informasi tambahan tentang status individu.
Ketika seseorang yang dikaitkan adaptor mesin dengan pengidentifikasi pelacakan tertentu muncul di aliran input untuk pertama kalinya, layanan biometrik menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien di mana WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType anggota WINBIO_CHANGE_TYPE_ARRIVAL. Struktur ini dikirim ke fungsi panggilan balik aplikasi Anda atau antrean pesan aplikasi sebelum struktur WINBIO_ASYNC_RESULT lainnya di mana WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.PresenceArray menyertakan struktur WINBIO_PRESENCE dengan nilai yang sama untuk WINBIO_PRESENCE. TrackingId.
Kombinasi nilai berikut dalam array struktur WINBIO_PRESENCE yang WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.PresenceArray menunjukkan jenis perubahan tertentu dalam status individu.
Ketika individu terlihat dalam bingkai kamera, tetapi mesin masih mencoba mengidentifikasi individu, anggota struktur WINBIO_PRESENCE memiliki nilai dalam tabel berikut.
Anggota Nilai TrackingId Bilangan bulat yang mengidentifikasi individu ke mesin. Keadaan S_OK Identity.Type WINBIO_ID_TYPE_NULL Dalam hal ini, layanan biometrik memperpanjang waktu kedaluwarsa untuk individu, dan tidak menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien untuk pengidentifikasi pelacakan tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType anggota WINBIO_CHANGE_TYPE_RECOGNIZE.
Pertama kali struktur WINBIO_ASYNC_RESULT mencakup struktur WINBIO_PRESENCE di mana anggota Status S_OK dan anggota Identity.Type WINBIO_ID_TYPE_NULL setelah satu atau beberapa struktur WINBIO_ASYNC_RESULT menyertakan struktur WINBIO_PRESENCE dengan anggota Status WINBIO_E_BAD_CAPTURE, monitor kehadiran menghasilkan satu WINBIO_ASYNC_RESULT struktur untuk pengidentifikasi pelacakan tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType member adalah WINBIO_CHANGE_TYPE_TRACK. Struktur WINBIO_ASYNC_RESULT ini tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType member WINBIO_CHANGE_TYPE_TRACK memberi tahu klien bahwa masalah yang menyebabkan kesalahan WINBIO_E_BAD_CAPTURE telah diatasi. Untuk informasi selengkapnya tentang keadaan di mana struktur WINBIO_PRESENCE memiliki anggota Status WINBIO_E_BAD_CAPTURE, lihat deskripsi tentang bagaimana adaptor mesin memberikan umpan balik kepada pengguna untuk memperbaiki kegagalan pengenalan nanti di Komentar ini.
Ketika seseorang terlihat dalam bingkai kamera, tetapi mesin masih mencoba mengidentifikasi individu dan ingin memberikan umpan balik kepada pengguna tentang cara memperbaiki kegagalan pengenalan, anggota struktur WINBIO_PRESENCE memiliki nilai dalam tabel berikut.
Anggota Nilai TrackingId Bilangan bulat yang mengidentifikasi individu ke mesin. Keadaan WINBIO_E_BAD_CAPTURE Identity.Type WINBIO_ID_TYPE_NULL Properties.FacialFeatures.BoundingBox, jika nilai Faktor WINBIO_TYPE_FACIAL_FEATURES Lokasi wajah individu dalam bingkai kamera. Properties.Iris.BoundingBox, jika nilai Faktor WINBIO_TYPE_IRIS Lokasi iris atau iris individu dalam bingkai kamera. Dalam hal ini, layanan biometrik memperpanjang waktu kedaluwarsa untuk individu dan menghasilkan struktur WINBIO_ASYNC_RESULT untuk pengidentifikasi pelacakan tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType anggota WINBIO_CHANGE_TYPE_TRACK.
Ketika individu terlihat dalam bingkai kamera, dan adaptor mesin menentukan identitas individu, anggota struktur WINBIO_PRESENCE memiliki nilai dalam tabel berikut.
Anggota Nilai TrackingId Bilangan bulat yang mengidentifikasi individu ke mesin. Keadaan S_OK Identity.Type WINBIO_ID_TYPE_SID Identity.Value.Accountsid Pengidentifikasi keamanan (SID) individu. Dalam hal ini, layanan biometrik mengaitkan pengidentifikasi pelacakan dengan SID untuk individu dan menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien untuk pengidentifikasi pelacakan tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType anggota WINBIO_CHANGE_TYPE_RECOGNIZE. Layanan biometrik tidak menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien tambahan untuk pengidentifikasi pelacakan kecuali individu meninggalkan bingkai kamera.
Ketika individu terlihat dalam bingkai kamera, tetapi adaptor mesin menentukan dengan pasti bahwa individu tidak terdaftar, anggota struktur WINBIO_PRESENCE memiliki nilai dalam tabel berikut.
Anggota Nilai TrackingId Bilangan bulat yang mengidentifikasi individu ke mesin. Keadaan WINBIO_E_UNKNOWN_ID Identity.Type WINBIO_ID_TYPE_NULL Dalam hal ini, layanan biometrik mengaitkan pengidentifikasi pelacakan individu dengan identitas UNKNOWN, dan menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien untuk pengidentifikasi pelacakan tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType anggota WINBIO_CHANGE_TYPE_RECOGNIZE. Layanan biometrik tidak menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien tambahan untuk pengidentifikasi pelacakan kecuali individu meninggalkan bingkai kamera.
Ketika seseorang yang dikaitkan adaptor mesin dengan pengidentifikasi pelacakan tertentu meninggalkan bingkai kamera dan berhenti muncul dalam nilai yang dikembalikan fungsi EngineAdapterIdentifyAll , pengidentifikasi pelacakan akhirnya kedaluwarsa. Ketika pengidentifikasi pelacakan kedaluwarsa, layanan biometrik menghasilkan struktur WINBIO_ASYNC_RESULT sisi klien tempat WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.ChangeType member adalah WINBIO_CHANGE_TYPE_DEPART. Adaptor mesin dapat mencegah layanan biometrik menghasilkan struktur ini dengan nilai WINBIO_CHANGE_TYPE_DEPART dengan menyertakan struktur WINBIO_PRESENCE dalam array yang dikembalikan EngineAdapterIdentifyAll, tempat WINBIO_PRESENCE. Anggota status S_OK dan WINBIO_PRESENCE. Anggota Identity.Type WINBIO_ID_TYPE_NULL seperti yang dijelaskan sebelumnya dalam Keterangan ini. Tindakan ini memperpanjang waktu kedaluwarsa untuk pengidentifikasi pelacakan tanpa menyebabkan aktivitas sisi klien.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 10 [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2016 [hanya aplikasi desktop] |
| Header |
|