fungsi panggilan balik PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN (winbio_adapter.h)
Dipanggil oleh Windows Biometric Framework ketika komputer siap untuk memasuki status daya rendah atau ketika komputer telah terbangun dari status daya rendah. Tujuan dari fungsi ini adalah untuk memungkinkan adaptor merespons transisi dalam status daya komputer.
Sintaks
PIBIO_ENGINE_NOTIFY_POWER_CHANGE_FN PibioEngineNotifyPowerChangeFn;
HRESULT PibioEngineNotifyPowerChangeFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[in] ULONG PowerEventType
)
{...}
Parameter
[in, out] Pipeline
Arahkan ke struktur WINBIO_PIPELINE yang terkait dengan unit biometrik yang melakukan operasi.
[in] PowerEventType
Menunjukkan sifat perubahan. Jenis dapat berupa salah satu dari nilai berikut:
- PBT_APMSUSPEND
Sistem memasuki status daya rendah.
- PBT_APMRESUMEAUTOMATIC
Sistem kembali dari status daya rendah.
- PBT_APMPOWERSTATUSCHANGE
Status sumber daya sistem berubah (misalnya sistem telah beralih dari baterai ke daya garis, atau baterai semakin rendah).
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.
Keterangan
Saat menerima peristiwa PBT_APMPOWERSTATUSCHANGE , adaptor harus memanggil Api Microsoft Win32GetSystemPowerStatus untuk menentukan status daya baru.
Kerangka kerja biometrik memanggil titik masuk adaptor ini secara asinkron dalam konteks utas arbitrer. Adaptor bertanggung jawab untuk menyinkronkan pemrosesan panggilan ini dengan pekerjaan lain yang mungkin dilakukannya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winbio_adapter.h |