Freigeben über


StorPortInitializeSListHead-Funktion (storport.h)

Initialisiert den Kopf einer verwalteten liste mit Storport verwalteter Verknüpfung.

Syntax

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

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.

Rückgabewert

StorPortInitializeSListHead 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
Der Listenkopf, auf den SListHead verweist, wurde erfolgreich initialisiert.
STOR_STATUS_INVALID_PARAMETER
Der Zeiger in SListHead ist NULL.

Hinweise

Wenn sie vom Aufrufer zugeordnet wird, muss die STOR_SLIST_HEADER Struktur, auf die SListHead verweist, an einer MEMORY_ALLOCATION_ALIGNMENT Grenze ausgerichtet werden. MEMORY_ALLOCATION_ALIGNMENT wird in miniport.h definiert.

Wenn Arbeitsspeicher für den Listenkopf freigegeben wird, muss jeder Zuordnungscode den ursprünglichen Speicherort des Puffers berücksichtigen, der die Listenkopfstruktur vor der Anpassung für MEMORY_ALLOCATION_ALIGNMENT enthält.

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

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList