Função RemoveTailList (wdm.h)

A rotina RemoveTailList remove uma entrada do final de uma lista duplamente vinculada de estruturas LIST_ENTRY .

Sintaxe

PLIST_ENTRY RemoveTailList(
  [in, out] PLIST_ENTRY ListHead
);

Parâmetros

[in, out] ListHead

Ponteiro para a estrutura LIST_ENTRY que serve como o cabeçalho de lista.

Retornar valor

RemoveTailList retorna um ponteiro para a entrada que estava na parte final da lista. Se a lista estiver vazia, RemoveTailList retornará ListHead.

Comentários

RemoveTailList remove a última entrada da lista definindo ListHead-Blink> para apontar para a última entrada na lista. A rotina define o membro Flink da nova primeira entrada como ListHead. Caso a lista esteja vazia, essa é efetivamente uma operação não operada.

Para obter informações sobre como usar essa rotina ao implementar uma lista duplamente vinculada, consulte Singly e Doubly Linked Listas.

Os chamadores de InsertHeadList podem estar em execução em qualquer IRQL. Se InsertHeadList for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento para ListHead e as entradas de lista deverão ser residentes.

Requisitos

Confira também

InitializeListHead

IsListEmpty

RemoveEntryList

RemoveHeadList