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 參數的記憶體必須位於所有 IRQL。

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何層級 (請參閱一節)

另請參閱

ExInterlockedInsertHeadList

ExInterlockedInsertTailList

InitializeListHead

KeInitializeSpinLock

RemoveHeadList