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

Подпрограмма RtlNumberGenericTableElementsAvl возвращает количество элементов в универсальной таблице.

Синтаксис

NTSYSAPI ULONG RtlNumberGenericTableElementsAvl(
  [in] PRTL_AVL_TABLE Table
);

Параметры

[in] Table

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

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

RtlNumberGenericTableElementsAvl возвращает количество элементов, хранящихся в таблице.

Замечания

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

#define RTL_USE_AVL_TABLES 0

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

Вызывающие Rtl.. Подпрограммы GenericTableAvl отвечают за исключительно синхронизацию доступа к универсальной таблице. Эксклюзивный быстрый мьютекс является наиболее эффективным механизмом синхронизации, используемым для этой цели.

Вызывающие RtlNumberGenericTableElementsAvl должны выполняться в IRQL < DISPATCH_LEVEL, если вызываемая память для универсальной таблицы может быть на страницу.

Требования

См. также

RtlInitializeGenericTableAvl

RtlIsGenericTableEmptyAvl