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 Lists。

ExInterlockedFlushSList 的调用方可以在任何 IRQL 上运行。 ListHead 参数和列表条目的存储必须驻留在所有 IRQL 中。