Функция RtlIsGenericTableEmptyAvl (ntddk.h)

Подпрограмма RtlIsGenericTableEmptyAvl определяет, пуста ли универсальная таблица.

Синтаксис

NTSYSAPI BOOLEAN RtlIsGenericTableEmptyAvl(
  [in] PRTL_AVL_TABLE Table
);

Параметры

[in] Table

Указатель на универсальную таблицу (RTL_GENERIC_TABLE). Таблица должна быть инициализирована путем вызова RtlInitializeGenericTableAvl.

Возвращаемое значение

RtlIsGenericTableEmptyAvl возвращает FALSE, если таблица содержит один или несколько элементов, TRUE в противном случае.

Замечания

По умолчанию операционная система использует деревья воспроизведения для реализации универсальных таблиц, но RtlIsGenericTableEmptyAvl подпрограмма работает только с деревьями Adelson-Velsky/Landis (AVL). Чтобы настроить универсальные подпрограммы таблиц для использования деревьев AVL вместо деревьев воспроизведения в драйвере, вставьте следующую инструкцию определения в общий файл заголовка перед включением Ntddk.h:

#define RTL_USE_AVL_TABLES 0

Если RTL_USE_AVL_TABLES не определен, необходимо использовать форму AVL универсальных подпрограмм таблиц. Например, используйте подпрограмму RtlIsGenericTableEmptyAvl вместо RtlIsGenericTableEmpty. В вызове RtlIsGenericTableEmptyAvlвызывающий объект должен передать структуру таблицы RTL_AVL_TABLE, а не RTL_GENERIC_TABLE.

Вызывающие RtlIsGenericTableEmptyAvl должны выполняться в ≤ APC_LEVEL, если выделенная вызывающим объектом память таблица доступен на страницу.

Требования

См. также

RtlInitializeGenericTableAvl