REQUEST_POWER_COMPLETE fungsi panggilan balik (wdm.h)
Rutinitas panggilan balik PowerCompletion menyelesaikan pemrosesan IRP daya.
Sintaks
REQUEST_POWER_COMPLETE RequestPowerComplete;
void RequestPowerComplete(
[in] PDEVICE_OBJECT DeviceObject,
[in] UCHAR MinorFunction,
[in] POWER_STATE PowerState,
[in, optional] PVOID Context,
[in] PIO_STATUS_BLOCK IoStatus
)
{...}
Parameter
[in] DeviceObject
Penunjuk ke DEVICE_OBJECT target untuk IRP daya yang telah selesai.
[in] MinorFunction
Menentukan kode fungsi minor dalam power IRP. Untuk informasi selengkapnya, lihat daftar kode IRP_MN_XXXX yang didukung di bagian Keterangan.
[in] PowerState
Menentukan status daya perangkat atau status daya sistem yang diteruskan ke rutinitas PoRequestPowerIrp .
[in, optional] Context
Pointer ke konteks yang diteruskan ke PoRequestPowerIrp.
[in] IoStatus
Penunjuk ke struktur IO_STATUS_BLOCK untuk IRP yang telah selesai.
Nilai kembali
Tidak ada
Keterangan
Driver yang mengirim IRP daya mungkin perlu melakukan tugas tambahan setelah semua driver lain menyelesaikan IRP. Jika demikian, driver pengirim harus mendaftarkan rutinitas panggilan balik PowerCompletion selama panggilan ke rutinitas PoRequestPowerIrp yang mengalokasikan IRP.
Rutinitas panggilan balik PowerCompletion driver hanya digunakan untuk IRP IRP_MJ_POWER yang memiliki kode IRP kecil IRP_MN_SET_POWER, IRP_MN_QUERY_POWER, dan IRP_MN_WAIT_WAKE. Untuk informasi selengkapnya, lihat Mengirim IRP_MN_QUERY_POWER atau IRP_MN_SET_POWER untuk Status Daya Perangkat dan Rutinitas Panggilan Balik Tunggu/Bangun.
Manajer I/O memanggil rutinitas PowerCompletion driver pengirim hanya setelah manajer I/O memanggil semua rutinitas IoCompletion yang ditetapkan oleh driver lain saat mereka melewati IRP ke bawah tumpukan. Rutinitas PowerCompletion melakukan tugas tambahan yang diperlukan pengirim IRP setelah semua driver lain menyelesaikan IRP. Rutinitas PowerCompletion tidak boleh membebaskan IRP—manajer daya melakukan itu.
Rutinitas PowerCompletion dipanggil di IRQL = PASSIVE_LEVEL atau IRQL = DISPATCH_LEVEL.
Contoh
Untuk menentukan rutinitas panggilan balik PowerCompletion , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk driver. 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 PowerCompletion yang diberi nama MyPowerCompletion
, gunakan jenis REQUEST_POWER_COMPLETE seperti yang ditunjukkan dalam contoh kode ini:
REQUEST_POWER_COMPLETE MyPowerCompletion;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
VOID
MyPowerCompletion(
PDEVICE_OBJECT DeviceObject,
UCHAR MinorFunction,
POWER_STATE PowerState,
PVOID Context,
PIO_STATUS_BLOCK IoStatus
)
{
// Function body
}
Jenis fungsi REQUEST_POWER_COMPLETE didefinisikan 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 REQUEST_POWER_COMPLETE 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 Menganotasi Perilaku Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
IRQL | Dipanggil di IRQL <= DISPATCH_LEVEL (lihat bagian Keterangan). |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk