Funzione ExInterlockedFlushSList (wdm.h)

Il ExInterlockedFlushSList routine rimuove in modo atomico tutte le voci da un elenco collegato sequenziato.

Sintassi

C++
NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

Parametri

[in, out] ListHead

Puntatore alla struttura SLIST_HEADER che funge da intestazione per l'elenco collegato sequenziato.

Valore restituito

Se sono presenti voci nell'elenco specificato, ExInterlockedFlushSList restituisce un puntatore alla prima struttura SLIST_ENTRY che era una voce nell'elenco; in caso contrario, restituisce NULL.

Osservazioni

ExInterlockedFlushSList non elimina le strutture SLIST_ENTRY che costituiscono l'elenco; imposta solo il puntatore interno di ListHead all'inizio dell'elenco su NULL. Il driver deve liberare le voci in modo esplicito.

La routine restituisce un puntatore alla prima struttura SLIST_ENTRY presente nell'elenco. Il driver può usare questo puntatore per scorrere le voci.

Per altre informazioni sull'uso di questa routine per implementare un elenco collegato sequenziato, vedere Elenchi collegati in sequenza e Doubly.

I chiamanti di ExInterlockedFlushSList possono essere eseguiti in qualsiasi IRQL. Lo spazio di archiviazione per il parametro ListHead e le voci dell'elenco devono risiedere in tutti gli IRQLs.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows 2000.
piattaforma di destinazione Universale
intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL Qualsiasi livello (vedere la sezione Osservazioni)

Vedere anche

exInitializeSListHead