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