Fungsi PowerSetRequest (winbase.h)
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 |