storPortQueueWorkItem 函式 (storport.h)
StorPortQueueWorkItem 會將 Storport 工作專案排入佇列,以在系統 (核心) 背景工作線程內執行。
語法
ULONG StorPortQueueWorkItem(
[in] PVOID HwDeviceExtension,
[in] PHW_WORKITEM WorkItemCallback,
[in] PVOID Worker,
[in, optional] PVOID Context
);
參數
[in] HwDeviceExtension
主機總線適配卡的硬體裝置擴充功能指標, (HBA) 。
[in] WorkItemCallback
迷你埠所提供之工作專案回呼例程的指標。 此例程會在系統線程的內容中呼叫,以處理 Worker 所指向的已排程工作專案。
[in] Worker
StorPortInitializeWorker 所傳回之已配置和初始化工作專案的不透明緩衝區指標。
[in, optional] Context
WorkItemCallback 中回呼例程所處理的 Worker 選擇性內容。
傳回值
StorPortQueueWorkItem 例程會傳回下列其中一個狀態代碼:
傳回碼 | Description |
---|---|
STOR_STATUS_BUSY | 工作專案已排入佇列進行處理。 |
STOR_STATUS_INVALID_DEVICE_STATE | 工作項目無法排入佇列,因為裝置正在進行移除。 |
STOR_STATUS_INVALID_IRQL | 目前的 IRQL 大於 DISPATCH_LEVEL。 |
STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension、 Worker 或 WorkItemCallback 為 NULL。 |
STOR_STATUS_SUCCESS | 工作專案已成功排入佇列。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 8 和更新版本的 Windows 中使用。 |
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
IRQL | <= DISPATCH_LEVEL |