StorPortInitializeSListHead-Funktion (storport.h)
Initialisiert den Head eines verwalteten Storport-verwalteten listenverknüpften Listen.
Syntax
ULONG StorPortInitializeSListHead(
[in] PVOID HwDeviceExtension,
[in, out] PSTOR_SLIST_HEADER SListHead
);
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.
Rückgabewert
StorPortInitializeSListHead gibt einen der folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert. |
|
Der Listenkopf, auf den SListHead verweist, wurde erfolgreich initialisiert. |
|
Der Zeiger in SListHead- ist NULL-. |
Bemerkungen
Bei der Zuordnung durch den Aufrufer muss die STOR_SLIST_HEADER Struktur, auf die SListHead- verweist, an einer MEMORY_ALLOCATION_ALIGNMENT Grenze ausgerichtet werden. MEMORY_ALLOCATION_ALIGNMENT wird in miniport.hdefiniert.
Wenn der Speicher für den Listenkopf freigegeben wird, muss jeder Deallocation-Code den ursprünglichen Speicherort des Puffers mit der Listenkopfstruktur vor der Anpassung für MEMORY_ALLOCATION_ALIGNMENTberücksichtigen.
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
StorPortInterlockedPopEntrySList