storPortInitializeWorker 函式 (storport.h)

建立在系統背景工作線程中執行的新 Storport 工作專案。

語法

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

參數

[in] HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標, (HBA) 。

[out] Worker

不透明緩衝區的指標,該緩衝區會保存工作項目的內容資訊。

傳回值

StorPortInitializeWorker 例程會傳回下列其中一個狀態代碼:

傳回碼 Description
STOR_STATUS_INVALID_IRQL
目前的 IRQL > DISPATCH_LEVEL。
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtensionWorker 為 NULL。
STOR_STATUS_INSUFFICIENT_RESOURCES
資源不足,無法初始化工作項目內容。
STOR_STATUS_SUCCESS
已成功初始化工作專案。

備註

StorPortInitializeWorker 在背景工作專案內容中傳回的工作專案內容會用於未來對 StorPortQueueWorkItemStorPortFreeWorker 的呼叫。

如果迷你埠在 IO 處理期間使用工作項目,建議您在迷你埠的 HwStorFindAdapter 函式期間呼叫 StorPortInitializeWorker,以確保在需要時可以使用資源。

規格需求

需求
最低支援的用戶端 可在 Windows 8 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 storport.h (包含 Storport.h)
IRQL <= DISPATCH_LEVEL

另請參閱

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem