Funzione PopEntryList (wdm.h)

  • Articolo

La routine PopEntryList rimuove la prima voce da un elenco collegato di SINGLE_LIST_ENTRY strutture.

Sintassi

PSINGLE_LIST_ENTRY PopEntryList(
  [in, out] PSINGLE_LIST_ENTRY ListHead
);

Parametri

[in, out] ListHead

Puntatore alla struttura SINGLE_LIST_ENTRY che rappresenta l'intestazione dell'elenco. In caso di ritorno, ListHead-Next> punta all'inizio dell'elenco con la prima voce rimossa.

Valore restituito

PopEntryList restituisce un puntatore alla voce rimossa dall'elenco oppure NULL se l'elenco è attualmente vuoto.

Commenti

PopEntryList rimuove la prima voce dall'elenco impostando ListHead-Next> in modo che punti alla seconda voce nell'elenco.

Per informazioni sull'uso di questa routine durante l'implementazione di un elenco collegato singly, vedere Singly e Doubly Linked Elenchi.

I chiamanti di PopEntryList possono essere eseguiti in qualsiasi IRQL. Se PopEntryList viene chiamato in IRQL >= DISPATCH_LEVEL, l'archiviazione per ListHead e le voci dell'elenco devono essere residenti.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 2000.
Piattaforma di destinazione Desktop
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL Qualsiasi livello (vedere la sezione Osservazioni)

Vedi anche

ExInterlockedPopEntryList

PushEntryList