Skip to content

Latest commit

 

History

History
129 lines (96 loc) · 3.46 KB

nf-storport-storportinterlockedflushslist.md

File metadata and controls

129 lines (96 loc) · 3.46 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:storport.StorPortInterlockedFlushSList
StorPortInterlockedFlushSList function (storport.h)
Removes all items from a Storport managed singly linked list. Access to the list is synchronized on a multiprocessor system.
storage\storportinterlockedflushslist.htm
storage
03/29/2018
StorPortInterlockedFlushSList function
StorPortInterlockedFlushSList, StorPortInterlockedFlushSList routine [Storage Devices], storage.storportinterlockedflushslist, storport/StorPortInterlockedFlushSList
storport.h
Storport.h
Universal
Available in starting with Windows 8.
<= DISPATCH_LEVEL
Windows
StorPortInterlockedFlushSList
storport/StorPortInterlockedFlushSList
APIRef
kbSyntax
HeaderDef
storport.h
StorPortInterlockedFlushSList

StorPortInterlockedFlushSList function

-description

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

-parameters

-param HwDeviceExtension [in]

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

-param SListHead [in, out]

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.

-param Result [out]

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.

-returns

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.

-see-also

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList