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 清單。

PopEntryList 的呼叫端可以在任何 IRQL 上執行。 如果在 IRQL >= DISPATCH_LEVEL呼叫 PopEntryList，則 ListHead 的記憶體和列表專案必須位於該處。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	桌面
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h)
IRQL	任何層級 (請參閱一節)

另請參閱

ExInterlockedPopEntryList

PushEntryList