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 RtlIsGenericTableEmptyAvl initialisiert worden sein.

Rückgabewert

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

Hinweise

Standardmäßig verwendet das Betriebssystem Splay-Strukturen, um generische Tabellen zu implementieren, aber die RtlIsGenericTableEmptyAvl-Routine funktioniert nur mit Adelson-Velsky/Landis-Strukturen (AVL). Um die generischen Tabellenroutinen so zu konfigurieren, dass sie AVL-Strukturen anstelle von Splaystrukturen in Ihrem Treiber verwenden, fügen Sie die folgende define-Anweisung in eine allgemeine Headerdatei ein, bevor Sie Ntddk.h einschließen:

#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 beispielsweise die RtlIsGenericTableEmptyAvl-Routine anstelle von RtlIsGenericTableEmpty. Im Aufruf von RtlIsGenericTableEmptyAvl muss der Aufrufer anstelle von RTL_GENERIC_TABLE eine RTL_AVL_TABLE Tabellenstruktur übergeben.

Aufrufer von RtlIsGenericTableEmptyAvl müssen unter ≤ APC_LEVEL ausgeführt werden, wenn der vom Aufrufer zugewiesene Arbeitsspeicher in Table ausgelagert werden kann.

Anforderungen

Weitere Informationen

RtlInitializeGenericTableAvl