IoAllocateWorkItem-Funktion (wdm.h)
Die IoAllocateWorkItem Routine weist eine Arbeitsaufgabe zu.
Syntax
PIO_WORKITEM IoAllocateWorkItem(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Zeigen Sie auf das Treiberobjekt des Aufrufers oder auf eines der Geräteobjekte des Aufrufers. Wenn der Aufrufer die Arbeitsaufgabe 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 keine ausreichenden Ressourcen vorhanden sind.
Bemerkungen
Der Treiber muss die Arbeitsaufgabe freigeben, die von IoAllocateWorkItem- zurückgegeben wird, indem IoFreeWorkItem-aufgerufen wird.
IoAllocateWorkItem eine Arbeitsaufgabe zuordnet und initialisiert. Eine verwandte Routine, IoInitializeWorkItem-, initialisiert eine Arbeitsaufgabe im Speicher, die der Treiber zuvor zugewiesen hat. Rufen Sie IoInitializeWorkItem- nicht auf, um eine Arbeitsaufgabe zu initialisieren, die von IoAllocateWorkItem-zugewiesen wurde.
Weitere Informationen zu Arbeitsaufgaben finden Sie unter System Worker Threads.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |