PO_FX_DEVICE_POWER_REQUIRED_CALLBACK fungsi panggilan balik (wdm.h)

Artikel
03/08/2023

Rutinitas panggilan balik DevicePowerRequiredCallback memberi tahu driver perangkat bahwa perangkat harus masuk dan tetap dalam status daya D0.

Sintaks

PO_FX_DEVICE_POWER_REQUIRED_CALLBACK PoFxDevicePowerRequiredCallback;

void PoFxDevicePowerRequiredCallback(
  [in] PVOID Context
)
{...}

Parameter

[in] Context

Penunjuk ke konteks perangkat. Driver perangkat menggunakan konteks ini untuk menyimpan informasi tentang status daya perangkat saat ini. Driver perangkat menentukan pointer ini di anggota DeviceContext dari struktur PO_FX_DEVICE yang digunakan driver untuk mendaftarkan perangkat dengan kerangka kerja manajemen daya (PoFx). Konteks ini buram untuk PoFx.

Nilai kembali

Tidak ada

Keterangan

Setelah PoFx memanggil rutinitas DevicePowerRequiredCallback driver, driver harus memulai transisi ke status D0 dengan mengirim D0 IRP (permintaan IRP_MN_SET_POWER ) ke tumpukan perangkat, jika perangkat belum dalam status D0. Setelah driver selesai (dan semua driver yang lebih rendah selesai) menangani permintaan ini, driver harus memanggil rutinitas PoFxReportDevicePoweredOn . Panggilan PoFxReportDevicePoweredOn memberi tahu PoFx bahwa perangkat menyelesaikan responsnya terhadap panggilan DevicePowerRequiredCallback . Driver dapat memanggil PoFxReportDevicePoweredOn selama atau setelah panggilan DevicePowerRequiredCallback .

Setiap kali rutinitas DevicePowerRequiredCallback dipanggil, driver harus merespons dengan memanggil PoFxReportDevicePoweredOn. Panggilan PoFxReportDevicePoweredOn dapat terjadi baik selama atau setelah panggilan DevicePowerRequiredCallback . Driver harus memanggil PoFxReportDevicePoweredOn terlepas dari apakah tidak ada IRP D0 yang diperlukan, permintaan IRP D0 gagal, atau IRP D0 yang dikirim berhasil atau gagal.

PoFx memanggil rutinitas DevicePowerRequiredCallback hanya jika PoFx sebelumnya memanggil rutinitas DevicePowerNotRequiredCallback driver untuk memberi tahu driver bahwa perangkat tidak diperlukan untuk tetap dalam status D0.

Panggilan ke rutinitas DevicePowerRequiredCallback dapat terjadi kapan saja setelah driver memanggil PoFxCompleteDevicePowerNotRequired untuk menyelesaikan panggilan balik DevicePowerNotRequiredCallback . Panggilan DevicePowerRequiredCallback tidak selalu terjadi sebagai akibat dari tindakan yang diambil oleh driver, seperti meminta agar komponen berubah ke kondisi aktif.

Contoh

Untuk menentukan rutinitas panggilan balik DevicePowerRequiredCallback , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan rutinitas panggilan balik DevicePowerRequiredCallback yang diberi nama MyDevicePowerRequiredCallback, gunakan jenis PO_FX_DEVICE_POWER_REQUIRED_CALLBACK seperti yang ditunjukkan dalam contoh kode ini:

PO_FX_DEVICE_POWER_REQUIRED_CALLBACK MyDevicePowerRequiredCallback;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyDevicePowerRequiredCallback(
    PVOID Context
    )
  {
      // Function body
  }

Jenis fungsi PO_FX_DEVICE_POWER_REQUIRED_CALLBACK ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan _Use_decl_annotations_ anotasi ke definisi fungsi Anda. Anotasi _Use_decl_annotations_ memastikan bahwa anotasi yang diterapkan ke jenis fungsi PO_FX_DEVICE_POWER_REQUIRED_CALLBACK dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang _Use_decl_annotations_, lihat Perilaku Fungsi Anotasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung dimulai dengan Windows 8.
Target Platform	Desktop
Header	wdm.h (termasuk Wudfwdm.h)
IRQL	Dipanggil di IRQL <= DISPATCH_LEVEL.