IO_CSQ_COMPLETE_CANCELED_IRP fungsi panggilan balik (wdm.h)

Artikel
03/08/2023

Rutinitas CsqCompleteCanceledIrp digunakan oleh sistem untuk memberi sinyal kepada driver bahwa ia dapat menyelesaikan IRP yang dibatalkan.

Sintaks

IO_CSQ_COMPLETE_CANCELED_IRP IoCsqCompleteCanceledIrp;

void IoCsqCompleteCanceledIrp(
  [in] PIO_CSQ Csq,
  [in] PIRP Irp
)
{...}

Parameter

[in] Csq

Arahkan ke struktur IO_CSQ untuk antrean IRP yang batal aman.

[in] Irp

Arahkan ke IRP yang akan dibatalkan.

Nilai kembali

Tidak ada

Keterangan

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

Sistem memanggil rutinitas ini untuk menyelesaikan IRP yang dibatalkan yang telah dihapus dari antrean driver. Biasanya, driver hanya memanggil IoCompleteRequest untuk IRP dengan status STATUS_CANCELLED.

Driver tidak diharuskan untuk menghapus IRP dari antrean sebelum menyelesaikannya sebagai dibatalkan: sistem selalu memanggil rutinitas CsqRemoveIrp antrean untuk menghapus IRP dari antrean sebelum memanggil CsqCompleteCanceledIrp.

Contoh

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

IO_CSQ_COMPLETE_CANCELED_IRP MyCsqCompleteCanceledIrp;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID 
 MyCsqCompleteCanceledIrp(
    _In_ PIO_CSQ  Csq,
    _In_ PIRP  Irp
    )
  {
      // Function body
  }

Jenis fungsi IO_CSQ_COMPLETE_CANCELED_IRP 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_COMPLETE_CANCELED_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 Perilaku Fungsi Anotasi.