EVT_WDF_WORKITEM callback function (wdfworkitem.h)
[Applies to KMDF and UMDF]
A driver's EvtWorkItem event callback function performs the work that is associated with a specified work item.
Syntax
EVT_WDF_WORKITEM EvtWdfWorkitem;
void EvtWdfWorkitem(
[in] WDFWORKITEM WorkItem
)
{...}
Parameters
[in] WorkItem
A handle to a framework work-item object.
Return value
None
Remarks
Typically, a driver's EvtWorkItem callback function performs tasks that are specified by information that the driver stored in the context memory of a work-item object.
To register an EvtWorkItem callback function, the driver calls WdfWorkItemCreate.
After the EvtWorkItem callback function has performed the specified tasks, it must call WdfObjectDelete, unless the driver reuses work items.
For more information about work items, see Using Framework Work Items.
The EvtWorkItem callback function runs at IRQL = PASSIVE_LEVEL in the context of a system worker thread.
Requirements
Requirement | Value |
---|---|
Target Platform | Universal |
Minimum KMDF version | 1.0 |
Minimum UMDF version | 2.0 |
Header | wdfworkitem.h (include Wdf.h) |
IRQL | PASSIVE_LEVEL (see Remarks section) |