Função RtlIsGenericTableEmpty (ntddk.h)

A rotina RtlIsGenericTableEmpty determina se uma tabela genérica está vazia.

Sintaxe

NTSYSAPI BOOLEAN RtlIsGenericTableEmpty(
  [in] PRTL_GENERIC_TABLE Table
);

Parâmetros

[in] Table

Ponteiro para a tabela genérica (RTL_GENERIC_TABLE). A tabela deve ter sido inicializada chamando RtlInitializeGenericTable.

Retornar valor

RtlIsGenericTableEmpty retornará FALSE se a tabela contiver um ou mais elementos; caso contrário, TRUE .

Comentários

Por padrão, o sistema operacional usa árvores de reprodução para implementar tabelas genéricas. Em algumas circunstâncias, as operações em uma árvore de reprodução tornarão a árvore profunda e estreita e podem até mesmo transformá-la em uma linha reta. Árvores muito profundas degradam o desempenho das pesquisas. Você pode garantir uma implementação de árvore mais equilibrada e superficial de tabelas genéricas usando árvores Desvelsky/Landis (AVL). Se você quiser configurar as rotinas de tabela genéricas para usar árvores AVL em vez de árvores de reprodução no driver, insira a seguinte instrução define em um arquivo de cabeçalho comum antes de incluir Ntddk.h:

#define RTL_USE_AVL_TABLES 0

Se RTL_USE_AVL_TABLES não estiver definido, você deverá usar a forma AVL das rotinas de tabela genéricas. Por exemplo, use a rotina Da Estrutura RtlIsGenericTableEmptyAvl em vez de RtlIsGenericTableEmpty. Na chamada para RtlIsGenericTableEmptyAvl, o chamador deve passar uma estrutura de tabela RTL_AVL_TABLE em vez de RTL_GENERIC_TABLE.

Os chamadores de RtlIsGenericTableEmpty devem estar em execução no ≤ APC_LEVEL se a memória alocada pelo chamador em Table for paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina está disponível no Microsoft Windows 2000 e posterior.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (consulte a seção Comentários)

Confira também

RtlInitializeGenericTable