Fungsi PowerReadFriendlyName (powrprof.h)

Artikel
03/04/2024

Mengambil nama yang mudah diingat untuk pengaturan daya, subgrup, atau skema yang ditentukan. Jika parameter SchemeGuid bukan NULL tetapi parameter SubGroupOfPowerSettingsGuid dan PowerSettingGuid adalah NULL, nama yang mudah diingat dari skema daya akan dikembalikan. Jika parameter SchemeGuid dan SubGroupOfPowerSettingsGuid bukan NULL dan parameter PowerSettingGuid adalah NULL, nama subgrup yang mudah diingat akan dikembalikan. Jika parameter SchemeGuid, SubGroupOfPowerSettingsGuid, dan PowerSettingGuid bukan NULL, nama pengaturan daya yang mudah diingat akan ditampilkan.

Sintaks

DWORD PowerReadFriendlyName(
  [in, optional]  HKEY       RootPowerKey,
  [in, optional]  const GUID *SchemeGuid,
  [in, optional]  const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional]  const GUID *PowerSettingGuid,
  [out, optional] PUCHAR     Buffer,
  [in, out]       LPDWORD    BufferSize
);

Parameter

[in, optional] RootPowerKey

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

[in, optional] SchemeGuid

Pengidentifikasi skema daya.

[in, optional] SubGroupOfPowerSettingsGuid

Subgrup pengaturan daya. Gunakan NO_SUBGROUP_GUID untuk merujuk ke skema daya default.

Nilai	Makna
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Pengaturan dalam subgrup ini adalah 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 pengaturan PCI Express kontrol subgrup ini.

[in, optional] PowerSettingGuid

Pengidentifikasi pengaturan daya yang sedang digunakan.

[out, optional] Buffer

Penunjuk ke buffer yang menerima nama yang mudah diingat. Jika parameter ini NULL, parameter BufferSize menerima ukuran buffer yang diperlukan. String yang dikembalikan adalah semua string lebar (Unicode).

[in, out] BufferSize

Penunjuk ke variabel yang berisi ukuran buffer yang ditujukkan oleh parameter Buffer .

Jika parameter BufferADALAH NULL, fungsi mengembalikan ERROR_SUCCESS dan variabel menerima ukuran buffer yang diperlukan.

Jika ukuran buffer yang ditentukan tidak cukup besar untuk menyimpan data yang diminta, fungsi mengembalikan ERROR_MORE_DATA dan variabel menerima ukuran buffer yang diperlukan.

Nilai kembali

Mengembalikan ERROR_SUCCESS (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal. Jika ukuran buffer yang ditentukan oleh parameter BufferSize terlalu kecil, 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

Fungsi Manajemen Daya

Bagikan melalui