IoAllocateWorkItem-Funktion (wdm.h)
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 |