Funzione RtlIsGenericTableEmptyAvl (ntddk.h)
La routine RtlIsGenericTableEmptyAvl determina se una tabella generica è vuota.
Sintassi
NTSYSAPI BOOLEAN RtlIsGenericTableEmptyAvl(
[in] PRTL_AVL_TABLE Table
);
Parametri
[in] Table
Puntatore alla tabella generica (RTL_GENERIC_TABLE). La tabella deve essere stata inizializzata chiamando RtlIsGenericTableEmptyAvl.
Valore restituito
RtlIsGenericTableEmptyAvl restituisce FALSE se la tabella contiene uno o più elementi, TRUE in caso contrario.
Commenti
Per impostazione predefinita, il sistema operativo usa alberi splay per implementare tabelle generiche, ma la routine RtlIsGenericTableEmptyAvl funziona solo con alberi Adelson-Velsky/Landis (AVL). Per configurare le routine di tabella generiche per l'uso degli alberi AVL anziché degli alberi splay nel driver, inserire l'istruzione define seguente in un file di intestazione comune prima di includere Ntddk.h:
#define RTL_USE_AVL_TABLES 0
Se RTL_USE_AVL_TABLES non è definito, è necessario utilizzare il formato AVL delle routine di tabella generiche. Ad esempio, utilizzare la routine RtlIsGenericTableEmptyAvl anziché RtlIsGenericTableEmpty. Nella chiamata a RtlIsGenericTableEmptyAvl, il chiamante deve passare una struttura di tabella RTL_AVL_TABLE anziché RTL_GENERIC_TABLE.
I chiamanti di RtlIsGenericTableEmptyAvl devono essere in esecuzione in ≤ APC_LEVEL se la memoria allocata dal chiamante in Table è paginabile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows XP. |
| Piattaforma di destinazione | Universale |
| Intestazione | ntddk.h (include Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (vedere la sezione Osservazioni) |