Fungsi PowerEnumerate (powrprof.h)

Artikel
03/08/2023

Menghitung elemen yang ditentukan dalam skema daya. Fungsi ini biasanya dipanggil dalam perulangan yang meningkatkan parameter Indeks untuk mengambil subkunci sampai semuanya telah dijumlahkan.

Sintaks

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

Parameter

[in, optional] RootPowerKey

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[in, optional] SchemeGuid

Pengidentifikasi skema daya. Jika parameter ini NULL, enumerasi kebijakan daya dikembalikan.

[in, optional] SubGroupOfPowerSettingsGuid

Subgrup pengaturan daya. Jika parameter ini NULL, enumerasi pengaturan di bawah kunci PolicyGuid dikembalikan.

Nilai	Makna
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Pengaturan dalam subgrup ini akan menjadi bagian dari skema daya default.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Pengaturan dalam subgrup ini mengontrol konfigurasi manajemen daya dari hard disk drive sistem.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Pengaturan dalam konfigurasi kontrol subgrup ini dari tombol daya sistem.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Pengaturan dalam konfigurasi kontrol subgrup fitur manajemen daya prosesor ini.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Pengaturan dalam konfigurasi kontrol subgrup ini dari fitur manajemen daya video.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Pengaturan dalam subgrup ini mengontrol titik perjalanan alarm baterai dan tindakan.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Pengaturan dalam setelan tidur sistem kontrol subgrup ini.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Pengaturan dalam subgrup ini mengontrol pengaturan PCI Express.

[in] AccessFlags

Sekumpulan bendera yang menentukan apa yang akan dijumlahkan

Nilai	Makna
ACCESS_SCHEME 16	Menghitung skema daya. Parameter SchemeGuid dan SubgroupOfPowerSettingsGuid akan diabaikan.
ACCESS_SUBGROUP 17	Hitung subgrup di bawah SchemeGuid. Parameter SubgroupOfPowerSettingsGuid akan diabaikan.
ACCESS_INDIVIDUAL_SETTING 18	Hitung pengaturan daya individual di bawah SchemeGuid\SubgroupOfPowerSettingsGuid. Untuk menghitung pengaturan daya langsung di bawah kunci SchemeGuid , gunakan NO_SUBGROUP_GUID sebagai parameter SubgroupOfPowerSettingsGuid .

[in] Index

Indeks berbasis nol dari skema, subgrup, atau pengaturan yang sedang dijumlahkan.

[out, optional] Buffer

Penunjuk ke variabel untuk menerima elemen. Jika parameter ini NULL, fungsi mengambil ukuran buffer yang diperlukan.

[in, out] BufferSize

Penunjuk ke variabel yang pada input berisi ukuran buffer yang diacu oleh parameter Buffer . Jika parameter Bufferadalah NULL atau jika BufferSize tidak cukup besar, fungsi akan mengembalikan ERROR_MORE_DATA dan variabel menerima ukuran buffer yang diperlukan.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal. Jika ukuran buffer yang diteruskan dalam parameter BufferSize terlalu kecil, atau jika parameter Bufferadalah NULL, ERROR_MORE_DATA akan dikembalikan dan DWORD yang ditunjukkan oleh parameter BufferSize akan diisi dengan ukuran buffer yang diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	powrprof.h
Pustaka	PowrProf.lib
DLL	PowrProf.dll

Lihat juga

POWER_DATA_ACCESSOR

Fungsi Manajemen Daya

Bagikan melalui