Fungsi PowerRegisterForEffectivePowerModeNotifications (powersetting.h)

Artikel
08/25/2023

Mendaftarkan panggilan balik untuk menerima pemberitahuan perubahan mode daya yang efektif.

Sintaks

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

Parameter

Version

Menyediakan versi mode daya efektif maksimum yang dipahami pemanggil. Jika mode daya yang efektif berasal dari versi yang lebih baru, mode ini dikurangi menjadi versi yang kompatibel yang kemudian diteruskan ke panggilan balik.

Nilai berikut dapat diteruskan:

EFFECTIVE_POWER_MODE_V1 tersedia dimulai dengan Windows 10, versi 1809 dan melacak status penggerak daya performa dan penghemat baterai.
EFFECTIVE_POWER_MODE_V2 tersedia dimulai dengan Windows 10, versi 1903 dan melacak slider daya performa, penghemat baterai, mode permainan, dan status daya realitas campuran windows.

Callback

Penunjuk ke panggilan balik untuk memanggil saat mode daya yang efektif berubah. Ini juga akan dipanggil sekali setelah pendaftaran untuk menyediakan mode saat ini. Jika beberapa panggilan balik terdaftar menggunakan API ini, panggilan balik tersebut dapat dipanggil secara bersamaan.

Context

Konteks buram yang ditentukan penelepon.

RegistrationHandle

Handel ke pendaftaran. Gunakan handel ini untuk membatalkan pendaftaran pemberitahuan.

Nilai kembali

Mengembalikan S_OK (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal.

Keterangan

Segera setelah pendaftaran, panggilan balik akan dipanggil dengan nilai pengaturan daya saat ini. Jika pendaftaran terjadi saat mode daya berubah, Anda mungkin menerima beberapa panggilan balik; panggilan balik terakhir adalah pembaruan terbaru.

Persyaratan


Klien minimum yang didukung	Windows 10, versi 1809 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	powersetting.h
Pustaka	Powrprof.lib
DLL	Powrprof.dll

Bagikan melalui