Fungsi PowerWriteFriendlyName (powrprof.h)

Artikel
03/01/2024

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

Sintaks

DWORD PowerWriteFriendlyName(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

Parameter

[in, optional] RootPowerKey

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

[in] SchemeGuid

Pengidentifikasi skema daya.

[in, optional] SubGroupOfPowerSettingsGuid

Subgrup pengaturan daya. Parameter ini dapat menjadi salah satu nilai berikut yang ditentukan dalam WinNT.h. 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.

[in] Buffer

Nama yang mudah diingat, dalam karakter lebar (Unicode).

[in] BufferSize

Ukuran nama yang mudah diingat yang ditentukan oleh parameter Buffer , termasuk karakter NULL yang mengakhiri.

Mengembalikan nilai

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

Keterangan

Perubahan pada pengaturan untuk skema daya aktif tidak berlaku sampai Anda memanggil fungsi PowerSetActiveScheme .

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