StorPortQueryDepthSList-Funktion (storport.h)

Artikel
02/07/2025

Ruft die Anzahl der Einträge in einer von Storport verwalteten verknüpften Liste ab.

Syntax

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             Result
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

[in, out] SListHead

Ein Zeiger auf eine STOR_SLIST_HEADER Struktur, die den Kopf einer singly verknüpften Liste darstellt. Diese Struktur gilt als undurchsichtig und dient nur für den Storport-Treiber.

[out] Result

Ein Zeiger auf einen SHORT--Wert, der die Listentiefenanzahl empfängt.

Rückgabewert

StorPortQueryDepthSList gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_SUCCESS	Die Listentiefe wurde erfolgreich zurückgegeben.
STOR_STATUS_INVALID_PARAMETER	Ein Zeiger in SListHead- oder Result- ist NULL-.

Bemerkungen

Da StorPortQueryDepthSList- nicht verriegelt ist, ist der durch Result auf die Rückgabe verweisende Listentiefewert nicht zuverlässig, wenn mehrere Threads in der Liste ausgeführt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 8 verfügbar.
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

StorPortInitializeSListHead-

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

Freigeben über