StorPortInterlockedInsertTailList 函数 (storport.h)

项目
02/26/2024

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 进行初始化。

必须仅将此旋转锁与 StorPortInterlockedXxx列表 例程一起使用。

返回值

StorPortInterlockedInsertHeadList 返回以下状态代码之一：

返回代码	说明
STOR_STATUS_NOT_IMPLEMENTED	此函数未在活动操作系统上实现。
STOR_STATUS_SUCCESS	已成功删除列表项，或者列表已为空。
STOR_STATUS_INVALID_PARAMETER	ListHead 或 Result 中的指针为 NULL。