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

Lihat juga

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE