PO_FX_DIRECTED_POWER_UP_CALLBACK fungsi panggilan balik (wdm.h)

  • Artikel

Fungsi panggilan balik PO_FX_DIRECTED_POWER_UP_CALLBACK diimplementasikan oleh driver klien untuk menangani aktivitas daya khusus driver atas nama DFx ( Directed PoFx).

Sintaks

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  PVOID Context,
  ULONG Flags
)
{...}

Parameter

Context

Menyediakan pointer ke konteks yang diteruskan ke PoFxRegisterDevice.

Flags

Disiapkan untuk penggunaan masa mendatang.

Nilai kembali

Tidak ada

Keterangan

Driver WDM yang mendaftar dengan PoFx untuk dukungan manajemen daya diam runtime perlu menerapkan panggilan balik ini untuk menambahkan dukungan DFx.

Daftarkan implementasi Anda dari fungsi panggilan balik ini dengan mengatur anggota struktur PO_FX_DEVICE_V3 yang sesuai lalu panggil PoFxRegisterDevice.

Panggilan balik ini dipanggil ketika sistem menentukan perangkat perlu menyala setelah sebelumnya dimatikan dalam fungsi panggilan balik PO_FX_DIRECTED_POWER_DOWN_CALLBACK . Perangkat mungkin perlu dinyalakan ketika sistem keluar dari Siaga Modern, aktivator mulai berjalan, atau bangun yang dimulai perangkat keras terjadi.

Ketika panggilan balik ini dipanggil, driver biasanya melakukan tugas tingkat tinggi berikut:

  • Minta D0 IRP untuk menyalakan perangkat.

  • Setelah IRP D0 selesai, hubungi PoFxReportDevicePoweredOn.

  • Buka blokir antrean I/O dan mulai memproses permintaan secara normal.

Setelah driver menyelesaikan panggilan daya yang diarahkan, driver dapat melanjutkan perilaku runtime-idle (RTD3).

Kontrak ini sangat mirip dengan S0, meskipun tidak ada S-IRP yang terlibat.

Perhatikan bahwa jika hierarki perangkat terlibat, kerangka kerja daya yang diarahkan meminta perangkat turunan untuk mematikan sebelum perangkat induk. Untuk perangkat induk tertentu, anak langsung (yang dijumlahkan oleh induk) dan turunan tidak langsung karena relasi daya dipertimbangkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1903
Header wdm.h (termasuk Wdm.h)

Lihat juga

Pengantar Kerangka Kerja Manajemen Daya Terarah

PO_FX_DIRECTED_POWER_DOWN_CALLBACK