Función RtlIsGenericTableEmpty (ntddk.h)
La rutina RtlIsGenericTableEmpty determina si una tabla genérica está vacía.
Sintaxis
NTSYSAPI BOOLEAN RtlIsGenericTableEmpty(
[in] PRTL_GENERIC_TABLE Table
);
Parámetros
[in] Table
Puntero a la tabla genérica (RTL_GENERIC_TABLE). La tabla debe haberse inicializado llamando a RtlInitializeGenericTable.
Valor devuelto
rtlIsGenericTableEmpty devuelve FALSE si la tabla contiene uno o varios elementos, TRUE de lo contrario.
Observaciones
De forma predeterminada, el sistema operativo usa árboles de reproducción para implementar tablas genéricas. En algunas circunstancias, las operaciones en un árbol de reproducción harán que el árbol sea profundo y estrecho e incluso puede convertirlo en una línea recta. Los árboles muy profundos degradan el rendimiento de las búsquedas. Puede garantizar una implementación de árbol más equilibrada y superficial de tablas genéricas mediante árboles Adelson-Velsky/Landis (AVL). Si desea configurar las rutinas de tabla genéricas para usar árboles AVL en lugar de árboles de reproducción en el controlador, inserte la siguiente instrucción define en un archivo de encabezado común antes de incluir Ntddk.h:
#define RTL_USE_AVL_TABLES 0
Si no se define RTL_USE_AVL_TABLES, debe usar el formulario AVL de las rutinas de tabla genéricas. Por ejemplo, use la rutina RtlIsGenericTableEmptyAvl Structure en lugar de RtlIsGenericTableEmpty. En la llamada a RtlIsGenericTableEmptyAvl, el autor de la llamada debe pasar una estructura de tabla de RTL_AVL_TABLE en lugar de RTL_GENERIC_TABLE.
Los autores de llamadas de RtlIsGenericTableEmpty deben ejecutarse en ≤ APC_LEVEL si la memoria asignada por el autor de la llamada en Table es paginable.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Esta rutina está disponible en Microsoft Windows 2000 y versiones posteriores. |
| de la plataforma de destino de | Universal |
| encabezado de | ntddk.h (incluya Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= APC_LEVEL (consulte la sección Comentarios) |