popEntryList 函数 (wdm.h)

  • 项目

PopEntryList 例程从SINGLE_LIST_ENTRY结构的单独链接列表中删除第一个条目。

语法

PSINGLE_LIST_ENTRY PopEntryList(
  [in, out] PSINGLE_LIST_ENTRY ListHead
);

参数

[in, out] ListHead

指向 SINGLE_LIST_ENTRY 结构的指针，该结构表示列表的标题。 返回时，ListHead-Next> 指向列表的开头，删除了第一个条目。

返回值

PopEntryList 返回指向从列表中删除的条目的指针;如果列表当前为空，则返回 NULL 。

注解

PopEntryList 通过将 ListHead-Next> 设置为指向列表中的第二个条目，从列表中删除第一个条目。

有关在实现单独链接列表时使用此例程的信息，请参阅 Singly 和 Doubly Linked Lists。

PopEntryList 的调用方可以在任何 IRQL 上运行。 如果在 IRQL >= DISPATCH_LEVEL调用 PopEntryList，则 ListHead 和列表条目的存储必须是驻留的。

要求

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

另请参阅

ExInterlockedPopEntryList

PushEntryList