Função IsListEmpty (wdm.h)

  • Artigo

A rotina IsListEmpty indica se uma lista duplamente vinculada de estruturas LIST_ENTRY está vazia.

Sintaxe

BOOLEAN IsListEmpty(
  [in] const LIST_ENTRY *ListHead
);

Parâmetros

[in] ListHead

Ponteiro para uma estrutura LIST_ENTRY que representa o cabeçalho da lista.

Retornar valor

IsListEmpty retornará TRUE se atualmente não houver entradas na lista e FALSE caso contrário.

Comentários

IsListEmpty retornará TRUE se ListHead-Flink> fizer referência a ListHead.

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

Os chamadores de IsListEmpty podem estar em execução em qualquer IRQL. Se IsListEmpty for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento para ListHead deverá ser residente.

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

RemoveEntryList

RemoveHeadList

RemoveTailList