Edit

EVT_WDF_WORKITEM callback function (wdfworkitem.h)

  • Article

[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)

See also

WdfObjectDelete

WdfWorkItemCreate

WdfWorkItemEnqueue