StorPortInterlockedInsertTailList 函式（storport.h）

發行項
02/07/2025

StorPortInterlockedInsertTailList 例程會以不可部分完成的方式在 STOR_LIST_ENTRY 結構之雙鏈接清單結尾插入專案。

語法

ULONG StorPortInterlockedInsertTailList(
  [in]      PVOID            HwDeviceExtension,
  [in, out] PSTOR_LIST_ENTRY ListHead,
  [in, out] PSTOR_LIST_ENTRY ListEntry,
  [in, out] PSTOR_LIST_ENTRY *Result,
  [in, out] PSTOR_KSPIN_LOCK Lock
);

參數

[in] HwDeviceExtension

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

[in, out] ListHead

代表清單前端之 STOR_LIST_ENTRY 結構的指標。

[in, out] ListEntry

STOR_LIST_ENTRY 結構的指標，表示要插入清單的專案。

[in, out] Result

STOR_LIST_ENTRY 結構的指標，表示插入新專案之前清單的第一個專案。

[in, out] Lock

STOR_KSPIN_LOCK 結構的指標，做為用來同步處理清單存取權的微調鎖定。微調鎖定的記憶體必須是常駐的，而且必須藉由呼叫 storPortInitializeSpinLock來初始化。

您只能搭配 StorPortInterlockedXxxList 例程使用此微調鎖定。

傳回值

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

傳回碼	描述
STOR_STATUS_NOT_IMPLEMENTED	此函式不會在作用中的作系統上實作。
STOR_STATUS_SUCCESS	已成功移除清單專案，或列表已經空白。
STOR_STATUS_INVALID_PARAMETER	ListHead 或 Result 中的指標 NULL。