IO_DPC_ROUTINE fungsi panggilan balik (wdm.h)

Artikel
03/08/2023

Rutinitas DpcForIsr menyelesaikan layanan operasi I/O, setelah rutinitas InterruptService kembali.

Sintaks

IO_DPC_ROUTINE IoDpcRoutine;

void IoDpcRoutine(
  [in]           PKDPC Dpc,
  [in]           _DEVICE_OBJECT *DeviceObject,
  [in, out]      _IRP *Irp,
  [in, optional] PVOID Context
)
{...}

Parameter

[in] Dpc

Penunjuk yang disediakan penelepon ke struktur KDPC , yang mewakili objek DPC yang terkait dengan rutinitas DpcForIsr ini.

[in] 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.

[in, optional] Context

Penunjuk yang disediakan penelepon ke informasi konteks yang ditentukan driver, ditentukan dalam panggilan sebelumnya ke IoRequestDpc.

Nilai kembali

Tidak ada

Keterangan

Untuk mendaftarkan rutinitas DpcForIsr untuk objek perangkat tertentu, driver harus memanggil IoInitializeDpcRequest, yang menyebabkan sistem mengalokasikan dan menginisialisasi satu objek DPC. (Jika Anda memerlukan beberapa rutinitas DPC, gunakan rutinitas CustomDpc .)

Untuk mengantrekan rutinitas DpcForIsr untuk eksekusi, rutinitas InterruptService driver harus memanggil IoRequestDPC.

Rutinitas DpcForIsr biasanya bertanggung jawab atas setidaknya tugas-tugas berikut:

Menyelesaikan operasi I/O yang dijelaskan oleh IRP yang diterima.
Menghapus antrean IRP berikutnya.

Jika driver menggunakan antrean IRP yang disediakan sistem, rutinitas DpcForIsr harus memanggil IoStartNextPacket atau IoStartNextPacketByKey, sehingga rutinitas StartIo driver akan mulai memproses permintaan I/O berikutnya.

Jika driver menggunakan antrean IRP internal, rutinitas DpcForIsr harus menghapus antrean IRP berikutnya dan mulai memproses permintaan I/O berikutnya.
Mengatur blok status I/O di IRP yang diterima dan memanggil IoCompleteRequest untuk permintaan yang telah selesai.

Rutinitas DpcForIsr mungkin juga mencoba kembali operasi yang gagal atau menyiapkan transfer berikutnya untuk permintaan I/O besar yang telah dipecah menjadi potongan yang lebih kecil.

Untuk informasi selengkapnya tentang rutinitas DpcForIsr , lihat Objek DPC dan DPC.

Contoh

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

IO_DPC_ROUTINE MyDpcForIsr;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyDpcForIsr(
    PKDPC  Dpc,
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp,
    PVOID  Context
    )
  {
      // Function body
  }

Jenis fungsi IO_DPC_ROUTINE 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_DPC_ROUTINE 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.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Dipanggil pada DISPATCH_LEVEL.

Bagikan melalui