Fungsi PowerReadACValue (powersetting.h)

  • Artikel

Mengambil nilai daya AC untuk pengaturan daya yang ditentukan.

Sintaks

DWORD PowerReadACValue(
  [in, optional]      HKEY       RootPowerKey,
  [in, optional]      const GUID *SchemeGuid,
  [in, optional]      const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional]      const GUID *PowerSettingGuid,
  [out, optional]     PULONG     Type,
  [out, optional]     LPBYTE     Buffer,
  [in, out, optional] 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. Parameter ini dapat menjadi salah satu nilai berikut yang ditentukan dalam WinNT.h. Gunakan NO_SUBGROUP_GUID untuk mengambil pengaturan untuk 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.

[out, optional] Type

Penunjuk ke variabel yang menerima jenis data untuk nilai tersebut. Nilai yang mungkin tercantum dalam Jenis Nilai Registri. Parameter ini bisa NULL dan jenis data tidak dikembalikan.

[out, optional] Buffer

Penunjuk ke buffer yang menerima nilai data. Jika parameter ini NULL, parameter BufferSize menerima ukuran buffer yang diperlukan.

[in, out, optional] BufferSize

Penunjuk ke variabel yang berisi ukuran buffer yang diacu 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 powersetting.h
Pustaka PowrProf.lib
DLL PowrProf.dll

Lihat juga

Fungsi Manajemen Daya