Funzione ExInterlockedFlushSList (wdm.h)

  • Articolo

La routine ExInterlockedFlushSList rimuove 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 nell'elenco specificato sono presenti voci, 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 Singly e Doubly Linked Elenchi.

I chiamanti di ExInterlockedFlushSList possono essere eseguiti in qualsiasi irQL. L'archiviazione per il parametro ListHead e le voci dell'elenco devono essere residenti in tutti gli ELENCHI di integrazione.

Requisiti

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)

Vedi anche

ExInitializeSListHead