IO_CSQ_INSERT_IRP fungsi panggilan balik (wdm.h)
Rutinitas CsqInsertIrp digunakan oleh sistem untuk memasukkan IRP ke dalam antrean IRP yang diterapkan driver dan batal-aman.
Sintaks
IO_CSQ_INSERT_IRP IoCsqInsertIrp;
void IoCsqInsertIrp(
[in] _IO_CSQ *Csq,
[in] PIRP Irp
)
{...}
Parameter
[in] Csq
Arahkan ke struktur IO_CSQ untuk antrean IRP yang batal aman.
[in] Irp
Arahkan ke IRP untuk disisipkan ke dalam antrean IRP.
Nilai kembali
Tidak ada
Keterangan
Driver menentukan rutinitas CsqInsertIrp untuk antrean IRP batal aman saat menginisialisasi struktur IO_CSQ antrean. Driver menentukan rutinitas sebagai parameter CsqInsertIrpdari IoCsqInitialize saat menginisialisasiIO_CSQ. Untuk informasi selengkapnya, lihat Antrean IRP Batal-Aman.
Rutinitas IoCsqInsertIrp dan IoCsqInsertIrpEx memanggil CsqInsertIrp untuk memasukkan IRP ke dalam antrean.
Contoh
Untuk menentukan rutinitas panggilan balik CsqInsertIrp , 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 CsqInsertIrp yang diberi nama MyCsqInsertIrp
, gunakan jenis IO_CSQ_INSERT_IRP seperti yang ditunjukkan dalam contoh kode ini:
IO_CSQ_INSERT_IRP MyCsqInsertIrp;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
NTSTATUS
MyCsqInsertIrp(
struct _IO_CSQ *Csq,
PIRP Irp
)
{
// Function body
}
Jenis fungsi IO_CSQ_INSERT_IRP 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 IO_CSQ_INSERT_IRP 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) |
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