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 會傳回下列其中一個狀態代碼:
傳回碼 | Description |
---|---|
|
此函式不會在作用中的操作系統上實作。 |
|
已成功初始化 SListHead 所指向的清單標頭。 |
|
SListHead 中的指標為 NULL。 |
備註
由呼叫端配置時,SListHead 所指向的STOR_SLIST_HEADER結構必須對齊MEMORY_ALLOCATION_ALIGNMENT界限。 MEMORY_ALLOCATION_ALIGNMENT 定義於 miniport.h中。
釋放清單前端的記憶體時,任何解除分配程式代碼都必須考慮包含清單前端結構之緩衝區的原始位置,再調整 MEMORY_ALLOCATION_ALIGNMENT。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
IRQL | <= DISPATCH_LEVEL |
另請參閱
StorPortInterlockedPopEntrySList