Funzione RemoveEntryList (wdm.h)
La routine RemoveEntryList rimuove una voce da un elenco collegato doubly di strutture LIST_ENTRY .
Sintassi
BOOLEAN RemoveEntryList(
[in] PLIST_ENTRY Entry
);
Parametri
[in] Entry
Puntatore alla struttura LIST_ENTRY che rappresenta la voce da rimuovere.
Valore restituito
RemoveEntryList restituisce TRUE se, dopo la rimozione della voce designata, l'elenco è vuoto. In caso contrario, la routine restituisce FALSE per indicare che l'elenco risultante contiene ancora una o più voci. Per informazioni, vedere la sezione Osservazioni di seguito.
Commenti
RemoveEntryList rimuove la voce impostando il membro Flink della voce prima dell'immissione per puntare alla voce dopo Entry e al membro Blink della voce dopo l'immissione per puntare alla voce prima di Entry.
Il valore restituito può essere usato per rilevare quando l'ultima voce viene rimossa dall'elenco. Un elenco vuoto è costituito solo da una testa elenco e nessuna voce di elenco.
In genere, la voce punta a una voce in un elenco e non alla testa dell'elenco. Tuttavia, l'immissione può puntare a una testa elenco, nel qual caso la routine rimuove la testa dell'elenco dall'elenco per produrre un elenco senza testa. Quando RemoveEntryList viene usato in questo modo, il valore restituito deve in genere essere ignorato. Per determinare se un elenco è vuoto, usare la routine IsListEmpty .
Per informazioni sull'uso di questa routine durante l'implementazione di un elenco collegato doubly, vedere Singly e Doubly Linked Elenchi.
I chiamanti di RemoveEntryList possono essere in esecuzione in qualsiasi irQL. Se RemoveEntryList viene chiamato in IRQL >= DISPATCH_LEVEL, l'archiviazione per le voci di elenco deve essere residente.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| IRQL | Qualsiasi livello (vedere la sezione Osservazioni) |
| Regole di conformità DDI | DoubleExFreePool(storport) |