IoFreeWorkItem function

The IoFreeWorkItem routine frees a work item that was allocated by IoAllocateWorkItem.

Syntax

NTKERNELAPI VOID IoFreeWorkItem(
  __drv_freesMem(Mem)PIO_WORKITEM IoWorkItem
);

Parameters

IoWorkItem

Pointer to an IO_WORKITEM structure that was returned by a previous call to IoAllocateWorkItem.

Return Value

None

Remarks

Only free a work item that is not currently queued. The system dequeues a work item before it runs the work item's callback routine, so IoFreeWorkItem can be called from within the WorkItem or WorkItemEx routine for the work item.

For more information about work items, see System Worker Threads.

Requirements

   
Windows version Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "<= DISPATCH_LEVEL"

See Also

IO_WORKITEM

IoAllocateWorkItem