Edit

Share via

StorPortFreeWorker function (storport.h)

  • Article

Frees a Storport work item previously allocated by the StorPortInitializeWorker routine.

Syntax

ULONG StorPortFreeWorker(
  [in] PVOID HwDeviceExtension,
       PVOID Worker
);

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

Worker

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

Return value

The StorPortInitializeWorker routine returns one of these status codes:

Return code Description
STOR_STATUS_INVALID_IRQL
 Current IRQL > DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER
 Either HwDeviceExtension or WorkItem is NULL.
STOR_STATUS_BUSY
 The work item is currently queued for processing.
STOR_STATUS_SUCCESS
 The work item was successfully freed.
STOR_STATUS_UNSUCCESSFUL
 The work item is already free.

Remarks

Miniports should call StorPortFreeWorker whenever a work item is no longer needed or when the miniport receives a PnP SRB notification that the adapter is removed.

Requirements

Requirement Value
Minimum supported client Available in Windows 8 and later versions of Windows.
Target Platform Universal
Header storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

See also

StorPortInitializeWorker

StorPortQueueWorkItem