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 参数的存储,列表条目必须驻留在所有 IRCL 中。

要求

要求 价值
最低支持的客户端 从 Windows 2000 开始可用。
目标平台 普遍
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别 (请参阅“备注”部分)

另请参阅

ExInitializeSListHead