Funzione StorPortInterlockedPushEntrySList (storport.h)

  • Articolo

Inserisce un elemento nella parte anteriore di un elenco collegato gestito da Storport. L'accesso all'elenco viene sincronizzato in un sistema multiprocessore.

Sintassi

ULONG StorPortInterlockedPushEntrySList(
  [in]      PVOID                              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER                 SListHead,
  [in, out] __drv_aliasesMem PSTOR_SLIST_ENTRY SListEntry,
  [out]     PSTOR_SLIST_ENTRY                  *Result
);

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.

[in, out] SListEntry

Puntatore a una struttura STOR_SLIST_ENTRY che rappresenta l'elemento da inserire nell'elenco collegato singly.

[out] Result

Puntatore a un puntatore a un puntatore di ingresso elenco. Il valore restituito è un puntatore all'elemento precedente esistente nella parte anteriore dell'elenco. Questo elemento precedente rimane nell'elenco dietro l'elemento nuovo aggiunto da SListEntry. Se l'elenco è vuoto, null viene restituito nel valore a cui fa riferimento result.

Valore restituito

StorPortInterlockedPushEntrySList 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
 L'elemento di elenco è stato inserito correttamente nell'elenco o è già vuoto.
STOR_STATUS_INVALID_PARAMETER
 Un puntatore in SListHead, SListEntry o Result è NULL.

Commenti

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

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

StorPortInitializeSListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortQueryDepthSList