KSERVICE_ROUTINE fungsi panggilan balik (wdm.h)

Rutinitas InterruptService (ISR) dengan cepat melayani perangkat yang mengganggu dan menjadwalkan pemrosesan pasca-interupsi data yang diterima, jika perlu.

Sintaks

KSERVICE_ROUTINE KserviceRoutine;

BOOLEAN KserviceRoutine(
  [in] _KINTERRUPT *Interrupt,
  [in] PVOID ServiceContext
)
{...}

Parameter

[in] Interrupt

Penunjuk yang disediakan penelepon ke struktur KINTERRUPT untuk interupsi.

[in] ServiceContext

Penunjuk yang disediakan penelepon ke informasi konteks, ditentukan dalam panggilan sebelumnya ke IoConnectInterrupt atau IoConnectInterruptEx.

Nilai kembali

Jika rutinitas menentukan bahwa interupsi tidak berasal dari salah satu perangkat driver, itu harus mengembalikan FALSE. Jika tidak, rutinitas harus melayani interupsi dan mengembalikan TRUE.

Keterangan

Untuk mendaftarkan ISR untuk vektor interupsi dan afinitas prosesor tertentu, driver harus memanggil IoConnectInterrupt atau IoConnectInterruptEx.

Rutinitas InterruptService (ISR) driver dijalankan dalam konteks interupsi, pada beberapa DIRQL yang ditetapkan sistem, seperti yang ditentukan oleh parameter SynchronizeIrql ke IoConnectInterrupt. (Perangkat lain, dengan nilai DIRQL yang lebih tinggi, dapat mengganggu ISR.)

Sebelum sistem memanggil ISR, sistem memperoleh kunci spin interupsi (parameter SpinLock ke IoConnectInterrupt), sehingga ISR tidak dapat secara bersamaan mengeksekusi pada prosesor lain. Setelah ISR kembali, sistem melepaskan kunci putaran.

ISR harus terlebih dahulu menentukan apakah gangguan berasal dari salah satu perangkat driver, dengan memeriksa informasi konteks yang disediakan oleh Context. Jika interupsi bukan dari salah satu perangkat driver, rutinitas harus segera mengembalikan FALSE sehingga manajer I/O dapat memanggil driver lain yang telah mendaftarkan ISR untuk prosesor yang sama dan vektor interupsi.

Untuk informasi selengkapnya tentang menerapkan ISR, lihat Rutinitas Layanan Interupsi.

Contoh

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

KSERVICE_ROUTINE MyInterruptService;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
BOOLEAN
  MyInterruptService(
    struct _KINTERRUPT  *Interrupt,
    PVOID  ServiceContext
    )
  {
      // Function body
  }

Jenis fungsi KSERVICE_ROUTINE 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 KSERVICE_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 Menganotasi Perilaku Fungsi.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Dipanggil di DIRQL (lihat bagian Keterangan).