RemoveEntryList - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
#ifndef _NTRTL_H
FORCEINLINE
BOOLEAN
NTAPI_INLINE
RemoveEntryList(
_In_ PLIST_ENTRY Entry
)
{
PLIST_ENTRY PrevEntry;
PLIST_ENTRY NextEntry;
NextEntry = Entry->Flink;
PrevEntry = Entry->Blink;
#if !defined(NO_LIST_ENTRY_CHECKS)
if ((NextEntry->Blink != Entry) || (PrevEntry->Flink != Entry))
{
RtlFatalListEntryError((PVOID)PrevEntry, (PVOID)Entry, (PVOID)NextEntry);
}
#endif
PrevEntry->Flink = NextEntry;
NextEntry->Blink = PrevEntry;
return NextEntry == PrevEntry;
}
View code on GitHub// wdm.h
BOOLEAN RemoveEntryList(
[in] PLIST_ENTRY Entry
);
View the official Windows Driver Kit DDI referenceThis function is documented in Windows Driver Kit.
The RemoveEntryList routine removes an entry from a doubly linked list of LIST_ENTRY structures.
Entry [in]Pointer to the LIST_ENTRY structure that represents the entry to be removed.
RemoveEntryList returns TRUE if, after removal of the designated entry, the list is empty. Otherwise, the routine returns FALSE to indicate that the resulting list still contains one or more entries. For information, see the Remarks section below.
RemoveEntryList removes the entry by setting the Flink member of the entry before Entry to point to the entry after Entry, and the Blink member of the entry after Entry to point to the entry before Entry.
The return value can be used to detect when the last entry is removed from the list. An empty list consists of a list head only and no list entries.
Typically, Entry points to an entry in a list and not to the list head. However, Entry can point to a list head, in which case the routine removes the list head from the list to produce a headless list. When RemoveEntryList is used in this way, the return value should typically be ignored. To determine whether a list is empty, use the IsListEmpty routine.
For information about using this routine when implementing a doubly linked list, see Singly and Doubly Linked Lists.
Callers of RemoveEntryList can be running at any IRQL. If RemoveEntryList is called at IRQL >= DISPATCH_LEVEL, the storage for the list entries must be resident.