ExInterlockedRemoveHeadList 函数 (wdm.h)

ExInterlockedRemoveHeadList 例程从 LIST_ENTRY 结构二次链接列表的开头删除一个条目。

语法

PLIST_ENTRY ExInterlockedRemoveHeadList(
  [in, out] PLIST_ENTRY ListHead,
  [in, out] PKSPIN_LOCK Lock
);

参数

[in, out] ListHead

指向用作列表标头的 LIST_ENTRY 结构的指针。

[in, out] Lock

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

返回值

ExInterlockedRemoveHeadList 返回指向从列表中删除的 LIST_ENTRY 结构的指针。 如果列表为空,则例程返回 NULL

言论

ExInterlockedRemoveHeadList 执行与 RemoveHeadList类似的作,但以原子方式执行。 不要在同一列表中混合原子和非原子调用。

有关使用此例程实现双重链接列表的详细信息,请参阅 Singly 和 Doubly 链接列表

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

要求

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

另请参阅

ExInterlockedInsertHeadList

ExInterlockedInsertTailList

InitializeListHead

KeInitializeSpinLock

RemoveHeadList