fungsi panggilan balik PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN (winbio_adapter.h)

Artikel
03/13/2024

Dipanggil oleh Windows Biometric Framework ketika sistem siap untuk memasuki status daya rendah atau ketika sistem telah terbangun dari status daya rendah. Tujuan dari fungsi ini adalah untuk memungkinkan adaptor merespons transisi dalam status daya komputer.

Sintaks

PIBIO_STORAGE_NOTIFY_POWER_CHANGE_FN PibioStorageNotifyPowerChangeFn;

HRESULT PibioStorageNotifyPowerChangeFn(
  [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:

Nilai	Makna
PBT_APMSUSPEND	Sistem memasuki status berdaya rendah
PBT_APMRESUMEAUTOMATIC	Sistem kembali dari status daya rendah.
PBT_APMPOWERSTATUSCHANGE	Status sumber daya sistem berubah (misalnya, sistem telah beralih dari daya baterai ke 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.

Menampilkan kode	Deskripsi
E_POINTER	Argumen Alur adalah NULL.
E_INVALIDARG	Argumen PowerEventType bukan salah satu nilai yang tercantum dalam tabel.

Keterangan

Saat menerima peristiwa PBT_APMPOWERSTATUSCHANGE , adaptor harus memanggil API Microsoft Win32 GetSystemPowerStatus 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

Bagikan melalui