Funzione ExInterlockedFlushSList (wdm.h)

La routine ExInterlockedFlushSList rimuove atomicamente tutte le voci da un elenco collegato sequenziato.

Sintassi

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.

Commenti

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 Singly e Doubly.

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

Requisiti

   
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)

Vedi anche

ExInitializeSListHead