StorPortInterlockedFlushSList function (storport.h)

Removes all items from a Storport managed singly linked list. Access to the list is synchronized on a multiprocessor system

Syntax

ULONG StorPortInterlockedFlushSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSTOR_SLIST_ENTRY  *Result
);

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

[in, out] SListHead

A pointer to an STOR_SLIST_HEADER structure that represents the head of a singly linked list. This structure is considered opaque and is for use by the Storport driver only.

[out] Result

A pointer to a list entry pointer. The value returned is a pointer to the items removed from the list. If the list is empty, then NULL is returned in value pointed to by Result.

Return value

StorPortInterlockedFlushSList returns one of the following status codes:

Return code Description
STOR_STATUS_NOT_IMPLEMENTED
This function is not implemented on the active operating system.
STOR_STATUS_SUCCESS
The list items were removed successfully or the list is already empty.
STOR_STATUS_INVALID_PARAMETER
A pointer in SListHead or Result is NULL.

Remarks

The StorPortInterlockedFlushSList will also return STATUS_SUCCESS when no entries are in the list. The pointer value referenced by Result must be evaluated for NULL to verify that no entries were returned.

Requirements

Requirement Value
Minimum supported client Available in starting with Windows 8.
Target Platform Universal
Header storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

See also

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList