IoAllocateWorkItem-Funktion (wdm.h)

Artikel
02/29/2024

Die IoAllocateWorkItem-Routine ordnet ein Arbeitselement zu.

Syntax

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Zeiger auf das Treiberobjekt des Aufrufers oder auf eines der Geräteobjekte des Aufrufers. Wenn der Aufrufer das Arbeitselement später an IoQueueWorkItem übergibt, muss DeviceObject auf ein Geräteobjekt verweisen.

Rückgabewert

IoAllocateWorkItem gibt einen Zeiger auf die zugeordnete IO_WORKITEM-Struktur zurück. Die Routine gibt NULL zurück, wenn nicht genügend Ressourcen vorhanden sind.

Hinweise

Der Treiber muss das von IoAllocateWorkItem zurückgegebene Arbeitselement durch Aufrufen von IoFreeWorkItem freigeben.

IoAllocateWorkItem ordnet ein Arbeitselement zu und initialisiert es. Eine zugehörige Routine, IoInitializeWorkItem, initialisiert ein Arbeitselement im Speicher, das der Treiber zuvor zugewiesen hat. Rufen Sie IoInitializeWorkItem nicht auf, um ein Arbeitselement zu initialisieren, das von IoAllocateWorkItem zugeordnet wurde.

Weitere Informationen zu Arbeitselementen finden Sie unter System Workerthreads.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen des Windows-Betriebssystems und in Windows Me. Diese Routine ist in Windows 98 nicht verfügbar.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL