Fungsi PoFxReportDevicePoweredOn (wdm.h)

  • Artikel

PoFxReportDevicePoweredOn rutin memberi tahu kerangka kerja manajemen daya (PoFx) bahwa perangkat menyelesaikan transisi yang diminta ke status daya D0 (sepenuhnya aktif).

Sintaks

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

Parameter

[in] Handle

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

Nilai kembali

Tidak ada

Keterangan

Driver untuk perangkat terdaftar harus memanggil PoFxReportDevicePoweredOn setelah salah satu kejadian berikut:

  • PoFx memanggil rutinitas panggilan balik DevicePowerRequiredCallback driver untuk memberi tahu driver bahwa perangkat harus memasuki status daya D0.
  • PoFx memanggil rutinitas panggilan balik DirectedPowerUpCallback driver untuk memberi tahu driver bahwa perangkat harus memasuki status daya D0.
  • PoFx mengirimkan driver IRP S0 (permintaan IRP_MN_SET_POWER ) untuk memberi tahu driver tentang transisi sistem yang tertunda ke status daya S0.
Menanggapi kemunculannya, driver mengirim D0 IRP (permintaan IRP_MN_SET_POWER ) ke tumpukan perangkatnya untuk memulai transisi ke status daya D0, jika perangkat belum dalam status D0. Setelah driver selesai (dan semua driver yang lebih rendah selesai) transisi ke status D0, driver memanggil PoFxReportDevicePoweredOn untuk memberi tahu PoFx.

Driver harus memanggil PoFxReportDevicePoweredOn terlepas dari apakah tidak ada IRP D0 yang diperlukan, permintaan IRP D0 gagal, IRP D0 yang dikirim berhasil atau gagal, atau IRP S0 berhasil atau gagal.

Untuk panggilan balik daya yang diperlukan/diarahkan daya, panggilan PoFxReportDevicePoweredOn dapat terjadi baik selama atau setelah panggilan balik.

Untuk permintaan S0 IRP, driver harus menyelesaikan permintaan ini sesegera mungkin, mengalihkan perangkat ke status daya D0, dan memanggil PoFxReportDevicePoweredOn. Untuk informasi selengkapnya, lihat Menangani Sistem Set-Power IRP di Pemilik Kebijakan Daya Perangkat.

Pada entri ke PoFxReportDevicePoweredOn, perangkat mungkin dalam status daya D0 yang tidak diinisialisasi di mana semua komponen dalam perangkat diaktifkan. Menanggapi panggilan PoFxReportDevicePoweredOn , PoFx mengonfigurasi perangkat dalam status D0 yang diinisialisasi. Selama konfigurasi ini, PoFx beralih komponen sebanyak mungkin ke status daya Fx berdaya rendah.

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

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice