NdisInitializeSListHead

NdisInitializeSListHead initializes the head of a sequenced, interlocked, singly linked list.

VOID 
  NdisInitializeSListHead(
    IN PSLIST_HEADER  SListHead
    );

Parameters

SListHead

Pointer to the caller-supplied list head to be initialized, which must be in resident memory.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

NdisInitializeSListHead zero-initializes the opaque list head at SListHead and sets the first-entry pointer to NULL.

The sequence number in an S-List is incremented each time an entry is inserted to, or removed from, the list.

All entries in an S-List must be nonpaged.

Any driver that uses an S-List must provide a spin lock to NdisInterlockedPushEntrySList and NdisInterlockedPopEntrySList. Before its initial call to either of these functions, the driver must initialize the spin lock with NdisAllocateSpinLock. To prevent deadlocks, the driver must not be holding this spin lock when it makes subsequent calls to NdisInterlockedPushEntrySList and NdisInterlockedPopEntrySList.

To manage a pool of fixed-size entries from nonpaged memory, consider using a lookaside list instead of an S-List.

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

Callers of NdisInitializeSListHead should be running at IRQL <= DISPATCH_LEVEL.

See Also

NdisInitializeNPagedLookasideList, NdisInterlockedPopEntrySList, NdisInterlockedPushEntrySList, NdisQueryDepthSList, NdisScheduleWorkItem