StorPortInitializeWorker 函数 (storport.h)

创建在系统工作线程中运行的新 Storport 工作项。

语法

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

[in] HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

[out] Worker

指向保存工作项上下文信息的不透明缓冲区的指针。

StorPortInitializeWorker 例程返回以下状态代码之一：

返回代码	说明
STOR_STATUS_INVALID_IRQL	当前 IRQL > DISPATCH_LEVEL。
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension 或 Worker 为 NULL。
STOR_STATUS_INSUFFICIENT_RESOURCES	可用资源不足，无法初始化工作项上下文。
STOR_STATUS_SUCCESS	已成功初始化工作项。

StorPortInitializeWorker 在 Worker 参数中返回的工作项上下文用于将来调用 StorPortQueueWorkItem 或 StorPortFreeWorker。

如果微型端口在 IO 处理期间使用工作项，我们建议在微型端口的 HwStorFindAdapter 函数期间调用 StorPortInitializeWorker，以确保资源在需要时可用。