Macro NdisInterlockedPopEntrySList (ndis.h)

Article
02/26/2024

La fonction NdisInterlockedPopEntrySList supprime la première entrée d’une liste séquencée et liée séparément.

Syntaxe

void NdisInterlockedPopEntrySList(
        SListHead,
  [in]  Lock
);

Paramètres

SListHead

Pointeur vers la tête de la liste séquencée et liée séparément à partir de laquelle l’entrée doit être retournée.

[in] Lock

Pointeur vers un verrou de rotation fourni par l’appelant, qui n’est pas actuellement détenu par l’appelant.

Valeur de retour

None

Remarques

Un pilote ne doit pas tenir le verrou donné lorsqu’il appelle NdisInterlockedPopEntrySList. Si nécessaire, le pilote doit appeler la fonction NdisReleaseSpinLock avant d’effectuer cet appel. NdisInterlockedPopEntrySList lui-même doit acquérir ce verrou de rotation pour supprimer la première entrée de la S-List, le cas échéant, de manière multiprocesseur-sécurisé.

L’appelant doit fournir un stockage résident pour le verrou, qui doit être initialisé avec la fonction NdisAllocateSpinLock avant l’appel initial à n’importe quel NdisInterlocked. Fonction SList .

Si NdisInterlockedPopEntrySList est appelé dans IRQL >= DISPATCH_LEVEL, le stockage du paramètre ListHead doit être résident.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisInterlockedPopEntrySList (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisInterlockedPopEntrySList (NDIS 5.1)) dans Windows XP.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	N’importe quel niveau