fungsi panggilan balik IO_TIMER_ROUTINE (wdm.h)

Artikel
07/02/2025

Rutinitas IoTimer adalah DPC yang, jika terdaftar, dipanggil sekali per detik.

Sintaksis

C++

IO_TIMER_ROUTINE IoTimerRoutine;

void IoTimerRoutine(
  [in]           _DEVICE_OBJECT *DeviceObject,
  [in, optional] PVOID Context
)
{...}

Parameter

[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, optional] Context

Penunjuk yang disediakan pemanggil ke informasi konteks yang ditentukan driver, ditentukan dalam panggilan sebelumnya ke IoInitializeTimer.

Mengembalikan nilai

Tidak

Komentar

Rutinitas IoTimer driver dijalankan dalam konteks DPC, di IRQL = DISPATCH_LEVEL.

Driver dapat mengaitkan IoTimer rutin dengan setiap objek perangkat yang dibuatnya. (Anda dapat menggunakan satu IoTimer rutin dengan beberapa objek perangkat, atau rutinitas terpisah dengan setiap objek perangkat.) Untuk mendaftarkan IoTimer rutin, driver harus memanggil IoInitializeTimer, menyediakan IoTimer alamat rutin dan pointer objek perangkat.

Untuk mengantrekan rutinitas IoTimer untuk eksekusi, rutinitas driver harus memanggil IoStartTimer. Sistem memanggil IoTimer rutin sekali per detik sampai driver memanggil IoStopTimer.

Untuk informasi selengkapnya tentang rutinitas IoTimer, lihat IoTimer Routines.

Contoh

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

C++

IO_TIMER_ROUTINE MyIoTimer;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

C++

_Use_decl_annotations_
VOID
  MyIoTimer(
    struct DEVICE_OBJECT  *DeviceObject,
    PVOID  Context
    )
  {
      // Function body
  }

Jenis fungsi IO_TIMER_ROUTINE ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan dengan lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi _Use_decl_annotations_ ke definisi fungsi Anda. Anotasi _Use_decl_annotations_ memastikan bahwa anotasi yang diterapkan ke jenis fungsi IO_TIMER_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 Anotasi Perilaku Fungsi.

Persyaratan

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

Bagikan melalui