Fungsi PoSetPowerRequest (wdm.h)

  • Artikel

Rutinitas PoSetPowerRequest menaikkan jumlah untuk jenis permintaan daya yang ditentukan.

Sintaks

NTSTATUS PoSetPowerRequest(
  [in, out] PVOID              PowerRequest,
  [in]      POWER_REQUEST_TYPE Type
);

Parameter

[in, out] PowerRequest

Penunjuk ke objek permintaan daya yang dibuat oleh rutinitas PoCreatePowerRequest .

[in] Type

Jenis permintaan daya. Atur parameter ini ke nilai enumerasi POWER_REQUEST_TYPE berikut:

  • PowerRequestSystemRequired

Nilai kembali

PoSetPowerRequest mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika panggilan gagal, kemungkinan kode pengembalian kesalahan meliputi yang berikut ini:

Menampilkan kode Deskripsi
STATUS_NOT_SUPPORTED
 Parameter Jenis diatur ke nilai yang tidak didukung.

Keterangan

Driver dapat memanggil rutinitas PoSetPowerRequest untuk meminta agar manajer daya mengambil alih beberapa jenis perilaku daya default, yang ditentukan sebagai nilai enumerasi POWER_REQUEST_TYPE . Untuk memulihkan perilaku default, driver membatalkan permintaan dengan memanggil rutinitas PoClearPowerRequest .

Manajer daya mempertahankan hitungan permintaan aktif untuk setiap jenis permintaan daya. Rutinitas PoSetPowerRequest menaikkan jumlah untuk jenis permintaan daya yang ditentukan satu per satu. PoClearPowerRequest secara rutin mengurangi hitungan satu per satu. Jumlah bukan nol menunjukkan bahwa permintaan dari satu atau beberapa komponen aktif. Setelah hitungan menurun menjadi nol, komputer kembali ke perilaku default untuk jenis permintaan daya yang ditentukan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 7.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Lihat juga

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest