RtlIsGenericTableEmptyAvl-Funktion (ntddk.h)

Die RtlIsGenericTableEmptyAvl Routine bestimmt, ob eine generische Tabelle leer ist.

Syntax

NTSYSAPI BOOLEAN RtlIsGenericTableEmptyAvl(
  [in] PRTL_AVL_TABLE Table
);

Parameter

[in] Table

Zeiger auf die generische Tabelle (RTL_GENERIC_TABLE). Die Tabelle muss durch Aufrufen von RtlInitializeGenericTableAvl initialisiert worden sein.

Rückgabewert

RtlIsGenericTableEmptyAvl gibt FALSE zurück, wenn die Tabelle ein oder mehrere Elemente enthält, TRUE andernfalls.

Bemerkungen

Standardmäßig verwendet das Betriebssystem Splay-Strukturen, um generische Tabellen zu implementieren, aber die RtlIsGenericTableEmptyAvl Routine funktioniert nur mit Adelson-Velsky/Landis (AVL)-Strukturen. Um die generischen Tabellenroutinen für die Verwendung von AVL-Strukturen anstelle von Wiedergabestrukturen in Ihrem Treiber zu konfigurieren, fügen Sie die folgende Define-Anweisung in eine allgemeine Headerdatei ein, bevor Ntddk.heingeschlossen wird:

#define RTL_USE_AVL_TABLES 0

Wenn RTL_USE_AVL_TABLES nicht definiert ist, müssen Sie die AVL-Form der generischen Tabellenroutinen verwenden. Verwenden Sie z. B. die RtlIsGenericTableEmptyAvl Routine anstelle von RtlIsGenericTableEmpty. Im Aufruf von RtlIsGenericTableEmptyAvlmuss der Aufrufer eine RTL_AVL_TABLE Tabellenstruktur statt RTL_GENERIC_TABLEübergeben.

Anrufer von RtlIsGenericTableEmptyAvl- müssen bei ≤ APC_LEVEL ausgeführt werden, wenn der vom Anrufer zugewiesene Speicher bei Table seitenfähig ist.

Anforderungen

Siehe auch

RtlInitializeGenericTableAvl