Função RtlIsGenericTableEmptyAvl (ntddk.h)
A rotina RtlIsGenericTableEmptyAvl determina se uma tabela genérica está vazia.
Sintaxe
NTSYSAPI BOOLEAN RtlIsGenericTableEmptyAvl(
[in] PRTL_AVL_TABLE Table
);
Parâmetros
[in] Table
Ponteiro para a tabela genérica (RTL_GENERIC_TABLE). A tabela deve ter sido inicializada chamando RtlIsGenericTableEmptyAvl.
Retornar valor
RtlIsGenericTableEmptyAvl 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, mas a rotina RtlIsGenericTableEmptyAvl só funciona com árvores Adelson-Velsky/Landis (AVL). Para 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 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 RtlIsGenericTableEmptyAvl 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 | Disponível a partir do Windows XP. |
| 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) |