NdisQueueIoWorkItem (Compact 2013)

3/26/2014

NDIS drivers call this function to queue a work item.

Syntax

VOID
  NdisQueueIoWorkItem(
    IN NDIS_HANDLE  NdisIoWorkItemHandle,
    IN NDIS_IO_WORKITEM_ROUTINE  Routine,
    IN PVOID  WorkItemContext
    );

Parameters

• NdisIoWorkItemHandle
  A handle to a private IO_WORKITEM structure that was returned by a previous call to the NdisAllocateIoWorkItem function.

• Routine
  The entry point to the routine that NDIS calls to process the work item. NDIS calls this routine in the context of a system thread. This routine is declared as follows.

  VOID
    (*NDIS_IO_WORKITEM_ROUTINE)(
      IN PVOID  WorkItemContext,
      IN NDIS_HANDLE  NdisIoWorkItemHandle
      );
  

  The routine includes the following input parameters:

  • WorkItemContext
    A pointer to the context area that the driver passed to the WorkItemContext parameter of NdisQueueIoWorkItem.
  • NdisIoWorkItemHandle
    A handle to a private NDIS_IO_WORKITEM structure that was returned by a previous call to the NdisAllocateIoWorkItem function.

• WorkItemContext
  A pointer to a caller-supplied context area that NDIS passes through to the callback routine. WorkItemContext can be any caller-specified data that the driver requires to manage the work item.

Return Value

None

Remarks

NdisQueueIoWorkItem calls IoQueueWorkItem to queue a work item. NDIS work items use the CriticalWorkQueue queue type.

The callback routine runs in a system thread context at IRQL = PASSIVE_LEVEL. This caller-supplied routine must call the NdisFreeIoWorkItem function to reclaim the storage allocated for the work item.

Requirements

See Also

Reference

NDIS I/O Work Item Functions
NdisAllocateIoWorkItem
NdisFreeIoWorkItem