FirstEntrySList function (wdm.h)

The FirstEntrySList routine returns the first entry in a sequenced singly linked list.

Syntax

PSLIST_ENTRY FirstEntrySList(
  [in] PSLIST_HEADER SListHead
);

Parameters

[in] SListHead

Pointer to the SLIST_HEADER structure that serves as the header for the sequenced singly linked list.

Return value

FirstEntrySList returns a pointer to the first SLIST_ENTRY structure on the list. If the list is empty, the routine returns NULL.

Remarks

Unlike other sequenced singly linked list routines, the FirstEntrySList routine is not atomic. For more information about sequenced singly linked lists, see Sequenced Singly Linked Lists. Callers of this routine can run at any level. If called at IRQL >= DISPATCH_LEVEL, the storage for ListHead must be resident.

Requirements

Requirement Value
Target Platform Universal
Header wdm.h (include Wdm.h, Ntifs.h, Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level

See also

SLIST_ENTRY

SLIST_HEADER