Funzione StorPortInitializeSListHead (storport.h)
Inizializza l'intestazione di un elenco collegato gestito di Storport.
Sintassi
ULONG StorPortInitializeSListHead(
[in] PVOID HwDeviceExtension,
[in, out] PSTOR_SLIST_HEADER SListHead
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per la scheda bus host (HBA).
[in, out] SListHead
Puntatore a una struttura STOR_SLIST_HEADER che rappresenta l'intestazione di un elenco collegato singly. Questa struttura è considerata opaca e viene utilizzata solo dal driver Storport.
Valore restituito
StorPortInitializeSListHead restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Questa funzione non viene implementata nel sistema operativo attivo. |
|
La testa dell'elenco a cui punta SListHead è stata inizializzata correttamente. |
|
Il puntatore in SListHead è NULL. |
Osservazioni
Se allocato dal chiamante, la struttura STOR_SLIST_HEADER a cui punta SListHead deve essere allineata a un limite MEMORY_ALLOCATION_ALIGNMENT. MEMORY_ALLOCATION_ALIGNMENT è definito in miniport.h.
Quando la memoria per l'intestazione dell'elenco viene liberata, qualsiasi codice di deallocazione deve tenere conto della posizione originale del buffer contenente la struttura head dell'elenco prima della rettifica per MEMORY_ALLOCATION_ALIGNMENT.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8. |
| piattaforma di destinazione | Universale |
| intestazione | storport.h (include Storport.h) |
| IRQL | <= DISPATCH_LEVEL |
Vedere anche
StorPortInterlockedPopEntrySList