Funzione RemoveEntryList (wdm.h)

Articolo
02/27/2024

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)

Vedi anche