NdisInterlockedPushEntrySList macro (ndis.h)

Article
02/22/2024

The NdisInterlockedPushEntrySList function inserts an entry at the head of a sequenced, singly linked list.

Syntax

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

Parameters

SListHead

A pointer to the head of the already initialized sequenced, singly linked list into which the specified entry is to be inserted.

SListEntry

A pointer to the entry to be inserted.

[in] Lock

A pointer to a caller-supplied spin lock, not currently held by the caller.

Return value

None

Remarks

Before the driver's initial call the NdisInterlockedPushEntrySList function, it must initialize the list head with the NdisInitializeSListHead function.

A driver must not be holding the given Lock when it calls NdisInterlockedPushEntrySList. If necessary, a driver must call the NdisReleaseSpinLock function before calling NdisInterlockedPushEntrySList. NdisInterlockedPushEntrySList must acquire this lock itself before it inserts ListEntry at the head of the list to ensure that this operation is handled in a multiprocessor-safe way.

The caller must provide resident storage for the Lock, which must be initialized with the NdisAllocateSpinLock function before the initial call to any NdisInterlocked..SList routine.

Drivers that retry I/O operations should use a doubly linked interlocked queue and the NdisInterlockedInsert/Remove..List functions, instead of an S-List.

If NdisInterlockedPushEntrySList is called at IRQL >= DISPATCH_LEVEL, the storage for the ListHead parameter and the list entries must be resident

Requirements

Requirement	Value
Minimum supported client	Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisInterlockedPushEntrySList (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisInterlockedPushEntrySList (NDIS 5.1)) in Windows XP.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
IRQL	Any level