Macro NdisInitializeSListHead (ndis.h)

Articolo
02/29/2024

La funzione NdisInitializeSListHead inizializza la testa di un elenco sequenziale, interlocked, collegato.

Sintassi

void NdisInitializeSListHead(
  [in]  SListHead
);

Parametri

[in] SListHead

Puntatore all'elenco fornito dal chiamante da inizializzare, che deve essere in memoria residente. La struttura deve essere allineata a 16 byte su piattaforme a 64 bit.

Valore restituito

nessuno

Osservazioni

NdisInitializeSListHead zero inizializza la testa dell'elenco opaco in SListHead e imposta il puntatore alla prima voce su NULL.

Il numero di sequenza in un elenco S viene incrementato ogni volta che una voce viene inserita o rimossa dall'elenco.

Tutte le voci in un elenco S devono essere non paginate.

Qualsiasi driver che usa un elenco S deve fornire un blocco di rotazione all'oggetto NdisInterlockedPushEntrySList e Funzioni NdisInterlockedPopEntrySList . Prima della chiamata iniziale a una di queste funzioni, il driver deve inizializzare il blocco spin con la funzione NdisAllocateSpinLock . Per evitare deadlock, il driver non deve contenere questo blocco di spin quando effettua chiamate successive a NdisInterlockedPushEntrySList e NdisInterlockedPopEntrySList.

Per gestire un pool di voci di dimensioni fisse dalla memoria non con pagine, è consigliabile usare un elenco lookaside anziché un elenco S-List.

I driver che ritentano le operazioni di I/O devono usare una coda interlocked doubly e le funzioni NdisInterlockedInsertHeadList, NdisInterlockedInsertTailList e NdisInterlockedRemoveHeadList, anziché un S-List.

Se NdisInitializeSListHead viene chiamato in IRQL >= DISPATCH_LEVEL, l'archiviazione per il parametro SListHead deve essere residente.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisInitializeSListHead (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisInitializeSListHead (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
IRQL	Qualsiasi livello