StorPortInitializeWorker function (storport.h)

Creates a new Storport work item that runs in a system worker thread.

Syntax

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Parameters

[in] HwDeviceExtension

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

[out] Worker

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

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 Worker is NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
Insufficient resources are available to initialize the work item context.
STOR_STATUS_SUCCESS
The work item was successfully initialized.

Remarks

The work item context returned in the Worker parameter by StorPortInitializeWorker is used in future calls to StorPortQueueWorkItem or StorPortFreeWorker.

If the miniport uses the work item during IO processing, we recommended that StorPortInitializeWorker be called during the miniport's HwStorFindAdapter function to ensure that resources are available when needed.

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

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem