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

要求

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

另请参阅

ExInitializeSListHead