ExInterlockedPopEntrySList-Funktion (wdm.h)

Die ExInterlockedPopEntrySList-Routine entfernt den ersten Eintrag atomar aus einer sequenzierten, singly verknüpften Liste.

Syntax

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedPopEntrySList (
    _Inout_ PSLIST_HEADER ListHead,
    _Inout_opt_ _Requires_lock_not_held_(*_Curr_) PKSPIN_LOCK Lock
    );

Parameter

[in, out] ListHead

Ein Zeiger auf die SLIST_HEADER-Struktur , die als Header für die sequenzierte, singly verknüpfte Liste dient. ListHead muss durch Aufrufen von ExInitializeSListHead initialisiert worden sein.

[in, out] Lock

Ein Zeiger auf eine KSPIN_LOCK-Struktur , die als Drehsperre dient, die zum Synchronisieren des Zugriffs auf die Liste verwendet wird. Der Speicher für die Spinsperre muss resident sein und durch Aufrufen von KeInitializeSpinLock initialisiert worden sein. Sie müssen diese Spinsperre nur mit den ExInterlockedXxxList-Routinen verwenden.

Rückgabewert

ExInterlockedPopEntrySList gibt einen Zeiger auf die erste SLIST_ENTRY Struktur in der Liste zurück. Wenn die Liste leer war, gibt die Routine NULL zurück.

Hinweise

Weitere Informationen zur Verwendung dieser Routine zum Implementieren einer sequenzierten, singly verknüpften Liste finden Sie unter Singly und Doubly Linked Listen.

Unter Windows 2000 müssen Treiber den Switch -D_WIN2K_COMPAT_SLIST_USAGE verwenden, um Code erfolgreich zu verknüpfen, der ExInterlockedPopEntrySList verwendet.

ExInterlockedPopEntrySList kann in jedem IRQL aufgerufen werden. Der Speicher für den ListHead-Parameter muss an allen IRQLs ansässig sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene (siehe Abschnitt Hinweise)

Weitere Informationen

ExInitializeSListHead

ExInterlockedPushEntrySList

ExInterlockedRemoveHeadList

ExQueryDepthSList

KeInitializeSpinLock