Freigeben über


StorPortQueryDepthSList-Funktion (storport.h)

Ruft die Anzahl der Einträge in einer von Storport verwalteten 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 Host bus adapter (HBA).

[in, out] SListHead

Ein Zeiger auf eine STOR_SLIST_HEADER-Struktur , die den Kopf einer eng verknüpften Liste darstellt. Diese Struktur gilt als undurchsichtig und kann nur vom Storport-Treiber verwendet werden.

[out] Result

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

Rückgabewert

StorPortQueryDepthSList gibt einen der folgenden status Codes zurück:

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

Hinweise

Da StorPortQueryDepthSList nicht miteinander verzahnt ist, ist der Listentiefewert, auf den das Ergebnis bei der Rückgabe verweist, nicht zuverlässig, wenn mehrere Threads in der Liste ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header storport.h (Storport.h einschließen)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList