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 | 任何级别 (请参阅备注部分) |