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 |