Fonction ExInterlockedPopEntrySList (wdm.h)

  • Article

La routine ExInterlockedPopEntrySList supprime atomiquement la première entrée d’une liste liée séquencée.

Syntaxe

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

Paramètres

[in, out] ListHead

Pointeur vers la structure SLIST_HEADER qui sert d’en-tête pour la liste liée séquencée. ListHead doit avoir été initialisé en appelant ExInitializeSListHead.

[in, out] Lock

Un pointeur vers une structure de KSPIN_LOCK qui sert de verrou de rotation utilisé pour synchroniser l’accès à la liste. Le stockage du verrou de rotation doit être résident et doit avoir été initialisé en appelant KeInitializeSpinLock. Vous devez utiliser ce verrou de rotation uniquement avec les routines ExInterlockedXxxList .

Valeur retournée

ExInterlockedPopEntrySList retourne un pointeur vers la première structure SLIST_ENTRY de la liste. Si la liste était vide, la routine retourne NULL.

Remarques

Pour plus d’informations sur l’utilisation de cette routine pour implémenter une liste liée séquencée, consultez Singly and Doubly Linked Listes.

Sur Windows 2000, les pilotes doivent utiliser le commutateur -D_WIN2K_COMPAT_SLIST_USAGE pour lier correctement le code qui utilise ExInterlockedPopEntrySList.

ExInterlockedPopEntrySList peut être appelé à n’importe quel IRQL. Le stockage du paramètre ListHead doit être résident à tous les IRQL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau (voir la section Remarques)

Voir aussi

ExInitializesListHead

ExInterlockedPushEntrysList

ExInterlockedRemoveHeadList

ExQueryDepthSList

KeInitializeSpinLock