Skip to content

Latest commit

 

History

History
129 lines (96 loc) · 3.1 KB

nf-storport-storportquerydepthslist.md

File metadata and controls

129 lines (96 loc) · 3.1 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.StorPortQueryDepthSList
StorPortQueryDepthSList function (storport.h)
Retrieves the number of entries in a Storport managed singly linked list.
storage\storportquerydepthslist.htm
storage
03/29/2018
StorPortQueryDepthSList function
StorPortQueryDepthSList, StorPortQueryDepthSList routine [Storage Devices], storage.storportquerydepthslist, storport/StorPortQueryDepthSList
storport.h
Storport.h
Universal
Available in starting with Windows 8.
<= DISPATCH_LEVEL
Windows
StorPortQueryDepthSList
storport/StorPortQueryDepthSList
APIRef
kbSyntax
HeaderDef
storport.h
StorPortQueryDepthSList

StorPortQueryDepthSList function

-description

Retrieves the number of entries in a Storport managed singly linked list.

-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 SHORT value which receives the list depth count.

-returns

StorPortQueryDepthSList 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 depth was successfully returned.
STOR_STATUS_INVALID_PARAMETER
A pointer in SListHead or Result is NULL.

-remarks

Since StorPortQueryDepthSList is not interlocked, the list depth value pointed to by Result on return is not reliable in when multiple threads are operating on the list.

-see-also

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList