IoFreeWorkItem function (wdm.h)

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

Syntax

void IoFreeWorkItem(
  [in] PIO_WORKITEM IoWorkItem
);

Parameters

[in] 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

Requirement Value
Minimum supported client 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