IO_WORKITEM_ROUTINE fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas WorkItem melakukan pemrosesan untuk item kerja yang diantrekan oleh rutinitas IoQueueWorkItem .

Sintaks

IO_WORKITEM_ROUTINE IoWorkitemRoutine;

void IoWorkitemRoutine(
  [in]           PDEVICE_OBJECT DeviceObject,
  [in, optional] PVOID Context
)
{...}

Parameter

[in] DeviceObject

Arahkan ke salah satu objek perangkat pemanggil. Ini adalah pointer yang diteruskan sebagai parameter DeviceObject ke IoAllocateWorkItem ketika item kerja dialokasikan, atau sebagai parameter IoObject ke IoInitializeWorkItem saat item kerja diinisialisasi.

[in, optional] Context

Menentukan informasi konteks khusus driver. Ini adalah nilai yang diteruskan sebagai parameter Konteks ke IoQueueWorkItem saat item kerja diantrekan.

Nilai kembali

Tidak ada

Keterangan

Driver mengantrekan rutinitas WorkItem dengan memanggil IoQueueWorkItem, dan utas pekerja sistem kemudian menjalankan rutinitas. Rutinitas WorkItem harus berjalan untuk waktu yang terbatas; jika tidak, sistem dapat kebuntuan. Untuk informasi selengkapnya, lihat Utas Pekerja Sistem.

Rutinitas WorkItem berjalan di IRQL = PASSIVE_LEVEL dan dalam konteks utas sistem.

Contoh

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

IO_WORKITEM_ROUTINE MyWorkItem;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyWorkItem(
    PDEVICE_OBJECT  DeviceObject,
    PVOID  Context 
    )
  {
      // Function body
  }

Jenis fungsi IO_WORKITEM_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_WORKITEM_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 PASSIVE_LEVEL.

Lihat juga

IO_WORKITEM

IoQueueWorkItem