Fungsi PowerSetRequest (winbase.h)

  • Artikel

Menaikkan jumlah permintaan daya dari jenis yang ditentukan untuk objek permintaan daya.

Sintaks

BOOL PowerSetRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

Parameter

[in] PowerRequest

Handel ke objek permintaan daya.

[in] RequestType

Jenis permintaan daya yang akan dinaikkan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
PowerRequestDisplayRequired Tampilan tetap aktif meskipun tidak ada input pengguna untuk jangka waktu yang lama.

Catatan: PowerRequestSystemRequired harus diambil selain PowerRequestDisplayRequired untuk memastikan tampilan tetap aktif dan sistem tidak tidur selama permintaan.
PowerRequestSystemRequired Sistem terus berjalan alih-alih memasuki tidur setelah periode tidak aktif pengguna.
PowerRequestAwayModeRequired Sistem memasuki mode menjauh alih-alih tidur sebagai respons terhadap tindakan eksplisit oleh pengguna. Dalam mode tandang, sistem terus berjalan tetapi mematikan audio dan video untuk memberikan tampilan tidur. PowerRequestAwayModeRequired hanya berlaku pada sistem Traditional Sleep (S3).
PowerRequestExecutionRequired Proses panggilan terus berjalan alih-alih ditangguhkan atau dihentikan oleh mekanisme manajemen seumur hidup proses. Kapan dan berapa lama proses diizinkan untuk berjalan tergantung pada sistem operasi dan pengaturan kebijakan daya.

Pada sistem Traditional Sleep (S3), permintaan PowerRequestExecutionRequired aktif menyiratkan PowerRequestSystemRequired.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan nilai bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Pada sistem Siaga Modern pada daya DC, sistem dan eksekusi permintaan daya yang diperlukan dihentikan 5 menit setelah batas waktu tidur sistem kedaluwarsa.

Kecuali untuk PowerRequestAwayModeRequired pada sistem Tidur Tradisional (S3), permintaan daya dihentikan setelah entri tidur sistem yang dimulai pengguna (tombol daya, tutup tutup atau pilih Tidur dari menu Mulai ).

Untuk menghemat daya dan memberikan pengalaman pengguna terbaik, aplikasi yang menggunakan permintaan daya harus mengikuti praktik terbaik ini:

  • Saat membuat permintaan daya, berikan string teks yang dilokalkan yang menjelaskan alasan permintaan dalam struktur REASON_CONTEXT .
  • Hubungi PowerSetRequest segera sebelum skenario yang memerlukan permintaan.
  • Panggil PowerClearRequest untuk mengurangi jumlah referensi untuk permintaan segera setelah skenario selesai.
  • Bersihkan semua objek permintaan dan handel terkait sebelum proses keluar atau layanan berhenti.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

PowerClearRequest

PowerCreateRequest