Fungsi PoFxStartDevicePowerManagement (wdm.h)

  • Artikel

Rutinitas PoFxStartDevicePowerManagement menyelesaikan pendaftaran perangkat dengan kerangka kerja manajemen daya (PoFx) dan memulai manajemen daya perangkat.

Sintaks

void PoFxStartDevicePowerManagement(
  [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

Setelah driver memanggil rutinitas PoFxRegisterDevice untuk mendaftarkan perangkat dengan PoFx, semua komponen dalam perangkat sepenuhnya menyala dan dalam kondisi aktif sehingga driver dapat selesai menginisialisasi perangkat keras. Untuk memulai manajemen daya aktif, driver harus memanggil PoFxStartDevicePowerManagement. Secara default, panggilan ini mengalihkan semua komponen ke kondisi diam.

Setelah PoFxStartDevicePowerManagement mengalihkan komponen ke kondisi diam, PoFx mungkin segera mulai memanggil rutinitas panggilan balik driver, bahkan sebelum PoFxStartDevicePowerManagement kembali. PoFx memanggil rutinitas panggilan balik ComponentIdleConditionCallback driver untuk menunjukkan bahwa komponen telah beralih ke kondisi diam. Driver tidak boleh mengakses komponen yang berada dalam kondisi menganggur. Sebelum driver dapat mengakses komponen, driver harus memanggil PoFxActivateComponent dan menunggu PoFx untuk memanggil rutinitas panggilan balik ComponentActiveConditionCallback driver. Panggilan balik ini memberi tahu driver bahwa komponen dalam kondisi aktif dan dapat diakses dengan aman.

Jika driver memerlukan komponen untuk berada dalam kondisi aktif segera setelah manajemen daya dimulai, driver harus secara eksplisit mengaktifkan komponen dengan memanggil rutinitas PoFxActivateComponent , dan panggilan ini harus terjadi setelah panggilan PoFxRegisterDevice tetapi sebelum panggilan PoFxStartDevicePowerManagement .

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 PASSIVE_LEVEL

Lihat juga

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice