DRIVER_CANCEL fungsi panggilan balik (wdm.h)

Artikel
02/27/2024

Rutinitas Batal membatalkan operasi I/O.

Sintaks

DRIVER_CANCEL DriverCancel;

void DriverCancel(
  [in, out] _DEVICE_OBJECT *DeviceObject,
  [in, out] _IRP *Irp
)
{...}

Parameter

[in, out] DeviceObject

Penunjuk yang disediakan penelepon ke struktur DEVICE_OBJECT . Ini adalah objek perangkat untuk perangkat target, yang sebelumnya dibuat oleh rutinitas AddDevice driver.

[in, out] Irp

Penunjuk yang disediakan penelepon ke struktur IRP yang menjelaskan operasi I/O yang akan dibatalkan.

Nilai kembali

Tidak ada

Keterangan

Ketika driver atau komponen sistem lain memanggil IoCancelIrp, manajer I/O memanggil rutinitas Batalkan IRP, jika telah terdaftar untuk IRP.

Untuk mendaftarkan rutinitas Batal untuk IRP, driver dapat menggunakan salah satu dari dua metode berikut:

Driver yang menyediakan rutinitas StartIo dan menggunakan antrean perangkat yang disediakan manajer I/O dapat menentukan rutinitas Batal saat memanggil IoStartPacket.
Driver yang membuat dan mengelola antrean perangkat tambahan dapat mendaftarkan rutinitas Batal dengan memanggil IoSetCancelRoutine.

Hanya satu rutinitas Batal yang dapat didaftarkan untuk IRP pada satu waktu.

Manajer I/O memanggil IoAcquireCancelSpinLock sebelum memanggil rutinitas Batalkan driver, sehingga rutinitas Batal harus memanggil IoReleaseCancelSpinLock di beberapa titik. Rutinitas tidak boleh menahan kunci putaran lebih lama dari yang diperlukan.

Rutinitas Batal dijalankan dalam konteks alur arbitrer di IRQL = DISPATCH_LEVEL hingga memanggil IoReleaseCancelSpinLock, yang mengubah IRQL menjadi nilai yang disediakan penelepon. Driver harus menentukan Irp-CancelIrql> untuk nilai ini.

Rutinitas Batal harus mengatur anggota Status blok status I/O ke STATUS_CANCELLED, dan mengatur anggota Informasi ke nol. Rutinitas kemudian harus menyelesaikan IRP yang ditentukan dengan memanggil IoCompleteRequest.

Untuk informasi terperinci tentang menerapkan rutinitas Batalkan driver, lihat Membatalkan IRP.

Contoh

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

DRIVER_CANCEL MyCancel;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyCancel(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp
    )
  {
      // Function body
  }

Jenis fungsi DRIVER_CANCEL 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 DRIVER_CANCEL 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 DISPATCH_LEVEL (lihat bagian Keterangan).

Bagikan melalui