Funzione ExInterlockedFlushSList (wdm.h)
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) |