共用方式為

StorPortQueryDepthSList 函式 （storport.h）

  • 發行項

擷取 Storport Managed 單項連結清單中的項目數。

語法

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             Result
);

參數

[in] HwDeviceExtension

主機總線適配卡 （HBA） 的硬體裝置擴充功能指標。

[in, out] SListHead

STOR_SLIST_HEADER 結構的指標，表示單向連結清單的前端。 此結構被視為不透明，且僅供 Storport 驅動程式使用。

[out] Result

接收清單深度計數之 SHORT 值的指標。

傳回值

StorPortQueryDepthSList 會傳回下列其中一個狀態代碼：

傳回碼 描述
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的作系統上實作。
STOR_STATUS_SUCCESS
 已成功傳回清單深度。
STOR_STATUS_INVALID_PARAMETER
 SListHead 或 Result 中的指標 NULL。

言論

由於 StorPortQueryDepthSList 未相互鎖定，因此當多個線程在清單中作業時，傳回時 Result 所指向的清單深度值並不可靠。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
IRQL <= DISPATCH_LEVEL

另請參閱

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList