Freigeben über


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

Siehe auch

IO_WORKITEM

IoFreeWorkItem-

IoInitializeWorkItem-

IoQueueWorkItem-

IoQueueWorkItemEx-