Fungsi IoQueueWorkItemEx (wdm.h)

Artikel
02/27/2024

Rutinitas IoQueueWorkItemEx mengaitkan rutinitas WorkItemEx dengan item kerja, dan menyisipkan item kerja ke dalam antrean untuk diproses nanti oleh utas pekerja sistem.

Sintaks

void IoQueueWorkItemEx(
  [in]           __drv_aliasesMem PIO_WORKITEM IoWorkItem,
  [in]           PIO_WORKITEM_ROUTINE_EX       WorkerRoutine,
  [in]           WORK_QUEUE_TYPE               QueueType,
  [in, optional] __drv_aliasesMem PVOID        Context
);

Parameter

[in] IoWorkItem

Arahkan ke struktur IO_WORKITEM yang dialokasikan oleh IoAllocateWorkItem atau diinisialisasi oleh IoInitializeWorkItem.

[in] WorkerRoutine

Penunjuk ke rutinitas WorkItemEx .

[in] QueueType

Menentukan nilai WORK_QUEUE_TYPE yang menetapkan jenis utas pekerja sistem untuk menangani item kerja. Driver harus menentukan DelayedWorkQueue.

[in, optional] Context

Menentukan informasi khusus driver untuk item kerja. Sistem meneruskan nilai ini sebagai parameter Konteks ke WorkItemEx.

Nilai kembali

Tidak ada

Keterangan

Rutinitas IoQueueWorkItemEx berbeda dari IoQueueWorkItem karena parameter WorkerRoutine adalah penunjuk ke rutinitas panggilan balik WorkItemEx , yang menyediakan driver dengan penunjuk ke struktur IO_WORKITEM untuk item kerja.

Untuk informasi selengkapnya tentang item kerja, lihat Utas Pekerja Sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Lihat juga