StorPortInitializeSListHead 函式（storport.h）

初始化 Storport Managed 單項連結清單的前端。

語法

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之前，先考慮包含清單前端結構的緩衝區原始位置。