Fungsi CallNtPowerInformation (powerbase.h)

  • Artikel

Mengatur atau mengambil informasi daya.

Sintaks

NTSTATUS CallNtPowerInformation(
  [in]  POWER_INFORMATION_LEVEL InformationLevel,
  [in]  PVOID                   InputBuffer,
  [in]  ULONG                   InputBufferLength,
  [out] PVOID                   OutputBuffer,
  [in]  ULONG                   OutputBufferLength
);

Parameter

[in] InformationLevel

Tingkat informasi yang diminta. Nilai ini menunjukkan informasi daya tertentu yang akan diatur atau diambil. Parameter ini harus menjadi salah satu nilai jenis enumerasi POWER_INFORMATION_LEVEL berikut.

Nilai Makna
AdministratorPowerPolicy
9
 Tingkat informasi ini tidak didukung.
LastSleepTime
15
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima ULONGLONG yang menentukan jumlah interupsi-waktu, dalam unit 100 nanodetik, pada waktu tidur sistem terakhir.
LastWakeTime
14
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima ULONGLONG yang menentukan jumlah interupsi-waktu, dalam unit 100 nanodetik, pada waktu bangun sistem terakhir.
ProcessorInformation
11
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima satu struktur PROCESSOR_POWER_INFORMATION untuk setiap prosesor yang diinstal pada sistem. Gunakan fungsi GetSystemInfo untuk mengambil jumlah prosesor.
ProcessorPowerPolicyAc
18
 Tingkat informasi ini tidak didukung.
ProcessorPowerPolicyCurrent
22
 Tingkat informasi ini tidak didukung.
ProcessorPowerPolicyDc
19
 Tingkat informasi ini tidak didukung.
SystemBatteryState
5
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima struktur SYSTEM_BATTERY_STATE yang berisi informasi tentang baterai sistem saat ini.
SystemExecutionState
16
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima nilai ULONG yang berisi buffer status eksekusi sistem. Nilai ini mungkin berisi kombinasi nilai berikut: ES_SYSTEM_REQUIRED, ES_DISPLAY_REQUIRED, atau ES_USER_PRESENT. Untuk informasi selengkapnya, lihat fungsi SetThreadExecutionState .
SystemPowerCapabilities
4
 Parameter lpInBuffer harus NULL, jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima struktur SYSTEM_POWER_CAPABILITIES yang berisi kemampuan daya sistem saat ini.

Informasi ini mewakili kemampuan daya yang saat ini didukung. Ini dapat berubah karena driver diinstal dalam sistem. Misalnya, penginstalan driver perangkat warisan yang tidak mendukung manajemen daya menonaktifkan semua status tidur sistem.
SystemPowerInformation
12
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima struktur SYSTEM_POWER_INFORMATION.

Aplikasi dapat menggunakan tingkat ini untuk mengambil informasi tentang diamnya sistem.
SystemPowerPolicyAc
0
 Jika lpInBuffer bukan NULL, fungsi menerapkan nilai SYSTEM_POWER_POLICY yang diteruskan dalam lpInBuffer ke kebijakan daya sistem saat ini yang digunakan saat sistem berjalan pada daya AC (utilitas).

Buffer lpOutputBuffer menerima struktur SYSTEM_POWER_POLICY yang berisi kebijakan daya sistem saat ini yang digunakan saat sistem berjalan pada daya AC (utilitas).
SystemPowerPolicyCurrent
8
 Parameter lpInBuffer harus NULL; jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Buffer lpOutputBuffer menerima struktur SYSTEM_POWER_POLICY yang berisi kebijakan daya sistem saat ini yang digunakan saat sistem berjalan pada daya AC (utilitas).
SystemPowerPolicyDc
1
 Jika lpInBuffer bukan NULL, fungsi menerapkan nilai SYSTEM_POWER_POLICY yang diteruskan dalam lpInBuffer ke kebijakan daya sistem saat ini yang digunakan saat sistem berjalan pada daya baterai.

Buffer lpOutputBuffer menerima struktur SYSTEM_POWER_POLICY yang berisi kebijakan daya sistem saat ini yang digunakan saat sistem berjalan pada daya baterai.
SystemReserveHiberFile
10
 Jika lpInBuffer bukan NULL dan pengguna saat ini memiliki hak istimewa yang memadai, fungsi menerapkan atau menonaktifkan penyimpanan yang diperlukan untuk menahan gambar hibernasi pada volume boot.

Parameter lpInBuffer harus menunjuk ke nilai BOOLEAN yang menunjukkan permintaan yang diinginkan. Jika nilainya TRUE, file hibernasi dicadangkan; jika nilainya FALSE, file hibernasi akan dihapus.
VerifyProcessorPowerPolicyAc
20
 Tingkat informasi ini tidak didukung.
VerifyProcessorPowerPolicyDc
21
 Tingkat informasi ini tidak didukung.
VerifySystemPolicyAc
2
 Tingkat informasi ini tidak didukung.
VerifySystemPolicyDc
3
 Tingkat informasi ini tidak didukung.

[in] InputBuffer

Penunjuk ke buffer input opsional. Jenis data buffer ini tergantung pada tingkat informasi yang diminta dalam parameter InformationLevel .

[in] InputBufferLength

Ukuran buffer input, dalam byte.

[out] OutputBuffer

Penunjuk ke buffer output opsional. Jenis data buffer ini tergantung pada tingkat informasi yang diminta dalam parameter InformationLevel . Jika buffer terlalu kecil untuk memuat informasi, fungsi akan mengembalikan STATUS_BUFFER_TOO_SMALL.

[in] OutputBufferLength

Ukuran buffer output, dalam byte. Tergantung pada tingkat informasi yang diminta, ini mungkin buffer berukuran bervariasi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu kode status berikut.

Status Makna
STATUS_BUFFER_TOO_SMALL
 Buffer output berukuran tidak cukup untuk memuat data yang akan dikembalikan.
STATUS_ACCESS_DENIED
 Pemanggil memiliki hak akses yang tidak mencukup untuk melakukan tindakan yang diminta.

Keterangan

Perubahan yang dilakukan pada kebijakan daya sistem saat ini menggunakan CallNtPowerInformation segera dilakukan, tetapi tidak persisten; artinya, perubahan tidak disimpan sebagai bagian dari skema daya. Setiap perubahan pada kebijakan daya sistem yang dibuat dengan CallNtPowerInformation dapat ditimpa oleh perubahan pada skema kebijakan yang dibuat oleh pengguna dalam program panel kontrol Power Options, atau dengan panggilan berikutnya ke WritePwrScheme, SetActivePwrScheme, atau fungsi skema daya lainnya.

Untuk informasi selengkapnya tentang menggunakan PowrProf.h, lihat Power Schemes.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header powerbase.h
Pustaka PowrProf.lib
DLL PowrProf.dll

Lihat juga

ADMINISTRATOR_POWER_POLICY

PROCESSOR_POWER_INFORMATION

PROCESSOR_POWER_POLICY

Fungsi Manajemen Daya

struktur SYSTEM_BATTERY_STATE

SYSTEM_POWER_CAPABILITIES

SYSTEM_POWER_INFORMATION

SYSTEM_POWER_POLICY