NdisInterlockedPushEntrySList-Makro (ndis.h)

Artikel
02/29/2024

Die NdisInterlockedPushEntrySList-Funktion fügt einen Eintrag am Anfang einer sequenzierten, singly verknüpften Liste ein.

Syntax

void NdisInterlockedPushEntrySList(
        SListHead,
        SListEntry,
  [in]  Lock
);

Parameter

SListHead

Ein Zeiger auf den Kopf der bereits initialisierten sequenzierten, singlich verknüpften Liste, in die der angegebene Eintrag eingefügt werden soll.

SListEntry

Ein Zeiger auf den einzufügenden Eintrag.

[in] Lock

Ein Zeiger auf eine vom Aufrufer bereitgestellte Spinsperre, die derzeit nicht vom Aufrufer gehalten wird.

Rückgabewert

Keine

Bemerkungen

Bevor der Treiber die Funktion NdisInterlockedPushEntrySList erstmalig aufruft , muss er den Listenkopf mit dem initialisieren. NdisInitializeSListHead-Funktion .

Ein Treiber darf die angegebene Sperre nicht halten, wenn er NdisInterlockedPushEntrySList aufruft. Bei Bedarf muss ein Treiber die NdisReleaseSpinLock-Funktion aufrufen, bevor er NdisInterlockedPushEntrySList aufruft. NdisInterlockedPushEntrySList muss diese Sperre selbst abrufen, bevor ListEntry am Anfang der Liste eingefügt wird, um sicherzustellen, dass dieser Vorgang auf eine multiprozessorsichere Weise behandelt wird.

Der Aufrufer muss residenten Speicher für die Sperre bereitstellen, die mit der NdisAllocateSpinLock-Funktion initialisiert werden muss, bevor der erste Aufruf von NdisInterlocked.. SList-Routine .

Treiber, die E/A-Vorgänge wiederholen, sollten eine doppelt verknüpfte ineinandergreifende Warteschlange und die NdisInterlockedInsert/Remove verwenden. Listenfunktionen anstelle einer S-Liste.

Wenn NdisInterlockedPushEntrySList unter IRQL >= DISPATCH_LEVEL aufgerufen wird, muss der Speicher für den ListHead-Parameter und die Listeneinträge resident sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisInterlockedPushEntrySList (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisInterlockedPushEntrySList (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
IRQL	Beliebige Ebene