Fungsi PoFxSetComponentWake (wdm.h)

Artikel
02/27/2024

Rutinitas PoFxSetComponentWake menunjukkan apakah driver mempersenjatai komponen yang ditentukan untuk bangun setiap kali komponen memasuki kondisi diam.

Sintaks

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

Parameter

[in] Handle

Handel yang mewakili pendaftaran perangkat dengan kerangka kerja manajemen daya (PoFx). Driver perangkat sebelumnya menerima handel ini dari rutinitas PoFxRegisterDevice .

[in] Component

Indeks yang mengidentifikasi komponen. Parameter ini adalah indeks ke dalam array Komponen dalam struktur PO_FX_DEVICE yang digunakan driver perangkat untuk mendaftarkan perangkat dengan PoFx. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

[in] WakeHint

Apakah driver mempersenjatai komponen untuk bangun setiap kali komponen memasuki kondisi diam. Jika TRUE, driver mempersenjatai komponen untuk bangun. Jika FALSE, driver tidak mempersenjatai komponen untuk bangun.

Nilai kembali

Tidak ada

Keterangan

Sebelum komponen memasuki status Fx berdaya rendah, driver mungkin mempersenjatai komponen untuk secara otomatis bangun sebagai respons terhadap sinyal input dari sumber eksternal (misalnya, jika pengguna mendorong tombol). Parameter WakeHint menginformasikan PoFx apakah driver mempersenjatai komponen untuk bangun. Jika komponen dipersenjatai untuk dibangunkan, PoFx tidak akan mengalihkan komponen ke status Fx berdaya rendah tempat komponen tidak dapat bangun.

Ketika perangkat terdaftar di PoFx, informasi pendaftaran untuk setiap komponen dalam perangkat terkandung dalam struktur PO_FX_COMPONENT terpisah. Anggota DeepestWakeableIdleState dari struktur ini menentukan status Fx terdalam dari mana komponen dapat bangun.

Driver perangkat dapat memanggil PoFxSetComponentWake setiap kali perubahan kondisi memerlukan perubahan nilai WakeHint . Setelah setiap panggilan, nilai WakeHint baru tetap berlaku sampai driver memanggil PoFxSetComponentWake lagi untuk memperbaruinya.

Jika komponen berada dalam kondisi menganggur saat PoFxSetComponentWake dipanggil, PoFx mungkin mengubah status Fx komponen untuk mengakomodasi nilai parameter WakeHint baru yang ditentukan oleh pemanggil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Universal
Header	wdm.h
Pustaka	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

Lihat juga

PO_FX_COMPONENT

Bagikan melalui