Fungsi PowerWriteIconResourceSpecifier (powrprof.h)

  • Artikel

Mengatur sumber daya ikon untuk pengaturan daya, subgrup, atau skema yang ditentukan.

Sintaks

DWORD PowerWriteIconResourceSpecifier(
  [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 subgrup ini mengontrol pengaturan PCI Express.

[in, optional] PowerSettingGuid

Pengidentifikasi pengaturan daya.

[in] Buffer

Sumber daya ikon.

[in] BufferSize

Ukuran buffer yang diacu oleh parameter Buffer .

Mengembalikan nilai

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

Keterangan

Jika parameter SchemeGuid bukan NULL tetapi parameter SubGroupOfPowerSettingsGuid dan PowerSettingGuid adalah 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 yang mudah diingat dari pengaturan daya akan diatur.

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