IO_CSQ_PEEK_NEXT_IRP fungsi panggilan balik (wdm.h)

Artikel
02/27/2024

Rutinitas CsqPeekNextIrp digunakan oleh sistem untuk menemukan IRP yang cocok berikutnya dalam antrean IRP yang diterapkan driver dan batal aman.

Sintaks

IO_CSQ_PEEK_NEXT_IRP IoCsqPeekNextIrp;

PIRP IoCsqPeekNextIrp(
  [in]           PIO_CSQ Csq,
  [in, optional] PIRP Irp,
  [in, optional] PVOID PeekContext
)
{...}

Parameter

[in] Csq

Arahkan ke struktur IO_CSQ untuk antrean IRP yang batal aman.

[in, optional] Irp

Arahkan ke IRP dalam antrean IRP driver, atau NULL untuk menentukan awal antrean.

[in, optional] PeekContext

Penunjuk ke informasi konteks yang ditentukan driver. Rutinitas CsqPeekNextIrp mengembalikan IRP pertama yang mengikuti Irp dan cocok dengan PeekContext.

Nilai kembali

CsqPeekNextIrp mengembalikan IRP pertama yang mengikuti Irp dalam antrean dan cocok dengan PeekContext, atau NULL jika tidak ada IRP yang cocok. Jika Irp adalah NULL, CsqPeekNextIrp mengembalikan IRP pertama yang cocok dalam antrean, atau NULL jika tidak ada IRP yang cocok.

Keterangan

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

Sistem ini menggunakan CsqPeekNextIrp untuk melakukan iterasi melalui IRP dalam antrean IRP driver. Misalnya, rutinitas IoCsqRemoveNextIrp menggunakan rutinitas ini untuk menemukan IRP yang akan dihapus.

Contoh

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

IO_CSQ_PEEK_NEXT_IRP MyCsqPeekNextIrp;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
PIRP 
 MyCsqPeekNextIrp(
    PIO_CSQ  Csq,
    PIRP  Irp,
    PVOID  PeekContext
    )
  {
      // Function body
  }

Jenis fungsi IO_CSQ_PEEK_NEXT_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_PEEK_NEXT_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.