fungsi panggilan balik PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN (winbio_adapter.h)

Artikel
03/03/2024

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

Sintaks

PIBIO_SENSOR_NOTIFY_POWER_CHANGE_FN PibioSensorNotifyPowerChangeFn;

HRESULT PibioSensorNotifyPowerChangeFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      ULONG PowerEventType
)
{...}

Parameter

[in, out] Pipeline

Penunjuk 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 berdaya 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.

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

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. Merupakan tanggung jawab adapter 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

Bagikan melalui