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之前，任何解除分配代码都必须考虑包含列表头结构的缓冲区的原始位置。