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 |
---|---|
|
Current IRQL > DISPATCH_LEVEL. |
|
Either HwDeviceExtension or Worker is NULL. |
|
Insufficient resources are available to initialize the work item context. |
|
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 |