NdisInitializeSListHead (Compact 7)

3/12/2014

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

Syntax

VOID 
  NdisInitializeSListHead(
    IN PSLIST_HEADER  SListHead
    );

Parameters

• SListHead
  A pointer to the caller-supplied list head to be initialized that must be in resident memory.

Return Value

None

Remarks

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 every time that 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 the NdisInterlockedPushEntrySList and NdisInterlockedPopEntrySList functions. Before its initial call to either of these functions, the driver must initialize the spin lock with the NdisAllocateSpinLock function. 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, instead of an S-List.

Requirements

See Also

Reference

NDIS Interlocked Functions Interface
NdisInitializeNPagedLookasideList
NdisInterlockedPopEntrySList
NdisInterlockedPushEntrySList
NdisQueryDepthSList
NdisQueueIoWorkItem