exInterlockedFlushSList 函式 (wdm.h)

ExInterlockedFlushSList 例程會以不可部分完成的方式從循序連結清單中移除所有專案。

語法

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

[in, out] ListHead

SLIST_HEADER 結構的指標，做為循序連結清單的標頭。

如果指定清單上有專案， ExInterlockedFlushSList 會傳回清單上專案之第一個 SLIST_ENTRY 結構的指標;否則會傳回 NULL。

ExInterlockedFlushSList 不會刪除組成清單 SLIST_ENTRY 結構;它只會將 ListHead 的內部指標設定為 NULL 清單的開頭。驅動程式必須明確釋放專案。

例程會傳回清單上第一 個SLIST_ENTRY 結構的指標。驅動程式可以使用這個指標逐一查看專案。

如需使用此例程實作循序連結清單的詳細資訊，請參閱 Singly 和 Doubly Linked 清單。

ExInterlockedFlushSList 的呼叫端可以在任何 IRQL 上執行。 ListHead 參數和清單專案的記憶體必須位於所有 IRCL。