InsertTailList-Funktion (wdm.h)

Artikel
02/27/2024

Die InsertTailList-Routine fügt einen Eintrag am Ende einer doppelt verknüpften Liste von LIST_ENTRY-Strukturen ein.

Syntax

void InsertTailList(
  [in, out] PLIST_ENTRY                  ListHead,
  [in, out] __drv_aliasesMem PLIST_ENTRY Entry
);

Parameter

[in, out] ListHead

Zeiger auf die LIST_ENTRY Struktur, die den Kopf der Liste darstellt.

[in, out] Entry

Zeiger auf eine LIST_ENTRY Struktur, die den Eintrag darstellt, der in die Liste eingefügt werden soll.

Rückgabewert

Keine

Bemerkungen

InsertTailList aktualisiert ListHead-Blink> so, dass auf Entry verweist. Entry-Blink> wird so aktualisiert, dass auf den alten letzten Eintrag in der Liste verweist, und Entry-Flink> auf ListHead festgelegt wird. Der Flink des vorherigen letzten Eintrags wird so aktualisiert, dass er ebenfalls auf Entry verweist.

Informationen zur Verwendung dieser Routine beim Implementieren einer doppelt verknüpften Liste finden Sie unter Singly und Doubly Linked Listen.

Aufrufer von InsertTailList können in jedem IRQL ausgeführt werden. Wenn InsertTailList unter IRQL >= DISPATCH_LEVEL aufgerufen wird, müssen der Speicher für ListHead und die Listeneinträge resident sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Desktop
Kopfzeile	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL	Beliebige Ebene (siehe Abschnitt "Hinweise")