Fungsi IoAllocateWorkItem (wdm.h)

Artikel
02/27/2024

Rutinitas IoAllocateWorkItem mengalokasikan item kerja.

Sintaks

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Arahkan ke objek driver penelepon atau ke salah satu objek perangkat pemanggil. Jika penelepon nantinya akan meneruskan item kerja ke IoQueueWorkItem, DeviceObject harus menunjuk ke objek perangkat.

Nilai kembali

IoAllocateWorkItem mengembalikan penunjuk ke struktur IO_WORKITEM yang dialokasikan. Rutinitas mengembalikan NULL jika sumber daya yang memadai tidak ada.

Keterangan

Driver harus membebaskan item kerja yang dikembalikan oleh IoAllocateWorkItem dengan memanggil IoFreeWorkItem.

IoAllocateWorkItem mengalokasikan dan menginisialisasi item kerja. Rutinitas terkait, IoInitializeWorkItem, menginisialisasi item kerja di penyimpanan yang sebelumnya telah dialokasikan driver. Jangan panggil IoInitializeWorkItem untuk menginisialisasi item kerja yang dialokasikan oleh IoAllocateWorkItem.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows, dan di Windows Me. Rutinitas ini tidak tersedia di Windows 98.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Lihat juga