Função PopEntryList (wdm.h)

  • Artigo

A rotina PopEntryList remove a primeira entrada de uma lista vinculada de estruturas de SINGLE_LIST_ENTRY .

Sintaxe

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

Parâmetros

[in, out] ListHead

Ponteiro para a estrutura SINGLE_LIST_ENTRY que representa o cabeçalho da lista. No retorno, ListHead-Next> aponta para o início da lista com a primeira entrada removida.

Retornar valor

PopEntryList retornará um ponteiro para a entrada removida da lista ou NULL se a lista estiver vazia no momento.

Comentários

PopEntryList remove a primeira entrada da lista definindo ListHead-Next> para apontar para a segunda entrada na lista.

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

Os chamadores de PopEntryList podem estar em execução em qualquer IRQL. Se PopEntryList for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento para ListHead e as entradas da 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

ExInterlockedPopEntryList

PushEntryList