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 | 任何層級 (請參閱一節) |