Macro NdisInterlockedPushEntrySList (ndis.h)

Articolo
02/26/2024

La funzione NdisInterlockedPushEntrySList inserisce una voce all'inizio di un elenco collegato sequenziato.

Sintassi

void NdisInterlockedPushEntrySList(
        SListHead,
        SListEntry,
  [in]  Lock
);

Parametri

SListHead

Puntatore all'intestazione dell'elenco sequenziato già inizializzato, collegato in modo singly in cui deve essere inserita la voce specificata.

SListEntry

Puntatore alla voce da inserire.

[in] Lock

Puntatore a un blocco di rotazione fornito dal chiamante, attualmente non mantenuto dal chiamante.

Valore restituito

nessuno

Osservazioni

Prima della chiamata iniziale del driver alla funzione NdisInterlockedPushEntrySList , deve inizializzare l'intestazione dell'elenco con il Funzione NdisInitializeSListHead .

Un driver non deve contenere il blocco specificato quando chiama NdisInterlockedPushEntrySList. Se necessario, un driver deve chiamare la funzione NdisReleaseSpinLock prima di chiamare NdisInterlockedPushEntrySList. NdisInterlockedPushEntrySList deve acquisire questo blocco prima di inserire ListEntry all'inizio dell'elenco per assicurarsi che questa operazione venga gestita in modo sicuro per più processi.

Il chiamante deve fornire l'archiviazione residente per Lock, che deve essere inizializzata con la funzione NdisAllocateSpinLock prima della chiamata iniziale a qualsiasi NdisInterlocked. Routine SList .

I driver che ritentano le operazioni di I/O devono usare una coda interlock collegata doubly e NdisInterlockedInsert/Remove.. Funzioni di elenco , invece di un elenco S.

Se NdisInterlockedPushEntrySList viene chiamato in IRQL >= DISPATCH_LEVEL, l'archiviazione per il parametro ListHead e le voci dell'elenco devono essere residenti

Requisiti

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