IO_CSQ_INSERT_IRP_EX fungsi panggilan balik (wdm.h)

Artikel
03/08/2023

Rutinitas CsqInsertIrpEx digunakan oleh sistem untuk memasukkan IRP ke dalam antrean IRP yang diterapkan driver dan aman untuk pembatalan.

Sintaks

IO_CSQ_INSERT_IRP_EX IoCsqInsertIrpEx;

NTSTATUS IoCsqInsertIrpEx(
  [in] _IO_CSQ *Csq,
  [in] PIRP Irp,
  [in] PVOID InsertContext
)
{...}

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.

[in] InsertContext

Arahkan ke konteks yang ditentukan driver untuk operasi penyisipan.

Nilai kembali

CsqInsertIrpEx mengembalikan STATUS_SUCCESS jika IRP telah berhasil dimasukkan, atau kode kesalahan yang sesuai tentang kegagalan.

Keterangan

Driver menentukan rutinitas CsqInsertIrpEx untuk antrean IRP yang aman batal ketika menginisialisasi struktur IO_CSQ antrean. Driver menentukan rutinitas sebagai parameter CsqInsertIrp dari IoCsqInitializeEx saat menginisialisasiIO_CSQ. Untuk informasi selengkapnya, lihat Antrean IRP Batal-Aman.

Rutinitas IoCsqInsertIrpEx memanggil CsqInsertIrpEx untuk menyisipkan IRP ke dalam antrean. Parameter InsertContext dari IoCsqInsertIrpEx diteruskan sebagai parameter InsertContext dari CsqInsertIrpEx.

Contoh

Untuk menentukan rutinitas panggilan balik CsqInsertIrpEx , 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 CsqInsertIrpEx yang diberi nama MyCsqInsertIrpEx, gunakan jenis IO_CSQ_INSERT_IRP_EX seperti yang ditunjukkan dalam contoh kode ini:

IO_CSQ_INSERT_IRP_EX MyCsqInsertIrpEx;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
NTSTATUS
 MyCsqInsertIrpEx(
    struct _IO_CSQ  *Csq,
    PIRP  Irp,
    PVOID  InsertContext
    )
  {
      // Function body
  }

Jenis fungsi IO_CSQ_INSERT_IRP_EX 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 IO_CSQ_INSERT_IRP_EX 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.