HwStorWorkItem routine

A miniport-provided callback function for processing a Storport work item request.

Syntax


VOID HwStorWorkItem(
  _In_      IN PVOID HwDeviceExtension,
  _In_opt_  PVOID Context,
  _In_      PVOID Worker
);

Parameters

HwDeviceExtension [in]

A pointer to the miniport driver's per-HBA storage area.

Context [in, optional]

Optional context provided by the miniport in the Callback parameter of StorPortQueueWorkItem.

Worker [in]

A pointer to an opaque buffer that holds context information for the work item returned by StorPortInitializeWorker.

Return value

None.

Remarks

If needed, a work item can be queued within HwStorWorkItem. Call StorPortQueueWorkItem with the current work item to reuse it. Otherwise, call StorPortFreeWorker to release the work item.

No locks are acquired by Storport when the callback is invoked. The miniport is responsible for any synchronization required in the callback routine.

The name HwStorWorkItem is just a placeholder for the miniport function that is pointed to by the Callback parameter of StorPortQueueWorkItem. The actual prototype of this routine is defined in Storport.h as follows:


typedef
VOID
HW_WORKITEM (
    _In_     PVOID HwDeviceExtension,
    _In_Opt_ PVOID Context,
    _In_     PVOID Worker,
    );

Requirements

Version

Available in Windows 8 and later versions of Windows.

Header

Storport.h (include Storport.h)

IRQL

PASSIVE_LEVEL

See also

StorPortFreeWorker
StorPortInitializeWorker
StorPortQueueWorkItem

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft