共用方式為

StorPortInterlockedPushEntrySList 函式 （storport.h）

  • 發行項

在 Storport Managed 單項連結清單的前面插入專案。 多重處理器系統上會同步處理清單的存取權。

語法

ULONG StorPortInterlockedPushEntrySList(
  [in]      PVOID                              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER                 SListHead,
  [in, out] __drv_aliasesMem PSTOR_SLIST_ENTRY SListEntry,
  [out]     PSTOR_SLIST_ENTRY                  *Result
);

參數

[in] HwDeviceExtension

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

[in, out] SListHead

STOR_SLIST_HEADER 結構的指標，表示單向連結清單的前端。 此結構被視為不透明，且僅供 Storport 驅動程式使用。

[in, out] SListEntry

STOR_SLIST_ENTRY 結構的指標，表示要插入至單向連結清單中的專案。

[out] Result

清單項目指標的指標。 傳回的值是清單前面存在之上一個專案的指標。 此上一個專案會保留在專案 SListEntry新增專案後方清單中。 如果清單是空的，則會以 Result所指向的值傳回 NULL。

傳回值

StorPortInterlockedPushEntrySList 會傳回下列其中一個狀態代碼：

傳回碼 描述
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的作系統上實作。
STOR_STATUS_SUCCESS
 清單專案已成功插入清單中，或已經是空的。
STOR_STATUS_INVALID_PARAMETER
 SListHead、SListEntry或 Result 中的指標 NULL。

言論

呼叫端配置時，SListEntry 所指向 STOR_SLIST_ENTRY 結構 必須對齊 MEMORY_ALLOCATION_ALIGNMENT 界限。 MEMORY_ALLOCATION_ALIGNMENT 定義於 miniport.h中。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
IRQL <= DISPATCH_LEVEL

另請參閱

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortQueryDepthSList