StorPortQueryDepthSList function (storport.h)

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

Syntax

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             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 SHORT value which receives the list depth count.

Return value

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.

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

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList