Função RemoveTailList (wdm.h)

  • Artigo

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

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL Qualquer nível (consulte a seção Comentários)

Confira também

InitializeListHead

IsListEmpty

RemoveEntryList

RemoveHeadList