Funzione StorPortInitializeSListHead (storport.h)

  • Articolo

Inizializza l'head di un elenco collegato gestito storport.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

[in, out] SListHead

Puntatore a una struttura STOR_SLIST_HEADER che rappresenta la testa di un elenco collegato singly. Questa struttura è considerata opaca ed è utilizzata solo dal driver Storport.

Valore restituito

StorPortInitializeSListHead restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_NOT_IMPLEMENTED
 Questa funzione non viene implementata nel sistema operativo attivo.
STOR_STATUS_SUCCESS
 La testa dell'elenco puntata da SListHead è stata inizializzata correttamente.
STOR_STATUS_INVALID_PARAMETER
 Il puntatore in SListHead è NULL.

Commenti

Quando allocato dal chiamante, la struttura STOR_SLIST_HEADER puntata da SListHead deve essere allineata a un limite MEMORY_ALLOCATION_ALIGNMENT . MEMORY_ALLOCATION_ALIGNMENT è definito in miniport.h.

Quando la memoria per il capo elenco viene liberata, qualsiasi codice deallocazione deve tenere conto della posizione originale del buffer contenente la struttura head dell'elenco prima della regolazione per MEMORY_ALLOCATION_ALIGNMENT.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

Vedi anche

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList