ExInterlockedPopEntryList 函数 (wdm.h)

ExInterlockedPopEntryList 例程从SINGLE_LIST_ENTRY结构的单独链接列表的开头原子删除条目。

语法

PSINGLE_LIST_ENTRY ExInterlockedPopEntryList(
  [in, out] PSINGLE_LIST_ENTRY ListHead,
  [in, out] PKSPIN_LOCK        Lock
);

[in, out] ListHead

指向用作列表标头的SINGLE_LIST_ENTRY 结构的指针。 ListHead 的存储必须驻留在所有 IRQL 中。

[in, out] Lock

指向 KSPIN_LOCK 结构的指针，该结构用作用于同步对列表的访问的旋转锁。旋转锁的存储必须是驻留的，并且必须已通过调用 KeInitializeSpinLock 进行初始化。必须仅将此旋转锁与 ExInterlockedXxx列表 例程一起使用。

ExInterlockedPopEntryList 返回指向从列表中删除的SINGLE_LIST_ENTRY 结构的指针。如果列表为空，则例程返回 NULL。

ExInterlockedPopEntryList 执行与 PopEntryList 相同的操作，但以原子方式执行。不要在同一列表中混合使用原子和非原子调用。

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

可以在任何 IRQL 中调用 ExInterlockedPopEntryList 例程。 ListHead 参数的存储必须驻留在所有 IRQL 中。