StorPortInitializeSListHead 函数 (storport.h)

初始化 Storport 托管单向链接列表的头。

语法

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

[in] HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

[in, out] SListHead

指向 STOR_SLIST_HEADER 结构的指针，该结构表示单独链接列表的标题。此结构被视为不透明，仅供 Storport 驱动程序使用。

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

返回代码	说明
STOR_STATUS_NOT_IMPLEMENTED	此函数未在活动操作系统上实现。
STOR_STATUS_SUCCESS	已成功初始化 SListHead 指向的列表头。
STOR_STATUS_INVALID_PARAMETER	SListHead 中的指针为 NULL。

由调用方分配时，SListHead 指向的STOR_SLIST_HEADER结构必须在MEMORY_ALLOCATION_ALIGNMENT边界上对齐。 MEMORY_ALLOCATION_ALIGNMENT 在 miniport.h 中定义。

释放列表头的内存时，在调整MEMORY_ALLOCATION_ALIGNMENT之前，任何解除分配代码都必须考虑包含列表头结构的缓冲区的原始位置。