Freigeben über


StorPortInterlockedFlushSList-Funktion (storport.h)

Entfernt alle Elemente aus einer von Storport verwalteten, singly verknüpften Liste. Der Zugriff auf die Liste wird auf einem Multiprozessorsystem synchronisiert.

Syntax

ULONG StorPortInterlockedFlushSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSTOR_SLIST_ENTRY  *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 einfach verknüpften Liste darstellt. Diese Struktur gilt als undurchsichtig und kann nur vom Storport-Treiber verwendet werden.

[out] Result

Ein Zeiger auf einen Listeneintragszeiger. Der zurückgegebene Wert ist ein Zeiger auf die Elemente, die aus der Liste entfernt wurden. Wenn die Liste leer ist, wird NULL im Wert zurückgegeben, auf den vom Ergebnis verwiesen wird.

Rückgabewert

StorPortInterlockedFlushSList 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 Listenelemente wurden erfolgreich entfernt oder die Liste ist bereits leer.
STOR_STATUS_INVALID_PARAMETER
Ein Zeiger in SListHead oder Result ist NULL.

Hinweise

StorPortInterlockedFlushSList gibt auch STATUS_SUCCESS zurück, wenn sich keine Einträge in der Liste befinden. Der von Result referenzierte Zeigerwert muss auf NULL ausgewertet werden, um zu überprüfen, ob keine Einträge zurückgegeben wurden.

Anforderungen

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

Weitere Informationen

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList