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 RtlIsGenericTableEmptyAvlinitialisiert 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows XP. |
| Zielplattform- | Universal |
| Header- | ntddk.h (enthalten Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL (siehe Abschnitt "Hinweise") |