Fungsi CallNtPowerInformation (powerbase.h)
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 |
---|---|
|
Tingkat informasi ini tidak didukung. |
|
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. |
|
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. |
|
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. |
|
Tingkat informasi ini tidak didukung. |
|
Tingkat informasi ini tidak didukung. |
|
Tingkat informasi ini tidak didukung. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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). |
|
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). |
|
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. |
|
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. |
|
Tingkat informasi ini tidak didukung. |
|
Tingkat informasi ini tidak didukung. |
|
Tingkat informasi ini tidak didukung. |
|
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 |
---|---|
|
Buffer output berukuran tidak cukup untuk memuat data yang akan dikembalikan. |
|
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 |