Función RtlEnumerateGenericTableWithoutSplayingAvl (ntddk.h)
La rutina RtlEnumerateGenericTableWithoutSplayingAvl se usa para enumerar los elementos de una tabla genérica.
Sintaxis
NTSYSAPI PVOID RtlEnumerateGenericTableWithoutSplayingAvl(
[in] PRTL_AVL_TABLE Table,
[in, out] PVOID *RestartKey
);
Parámetros
[in] Table
Puntero a la tabla genérica (RTL_AVL_TABLE). La tabla debe haberse inicializado llamando a RtlInitializeGenericTableAvl.
[in, out] RestartKey
Dirección del elemento devuelto por la llamada anterior a RtlEnumerateGenericTableWithoutSplayingAvl. Debe establecerse en null si la enumeración se inicia en el primer elemento de la tabla.
Para enumerar todos los elementos de la tabla, use RtlEnumerateGenericTableWithoutSplayingAvl de la manera siguiente:
RestartKey = NULL;
for (ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey);
ptr != NULL;
ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey)) {
// Process the element pointed to by ptr
}
Valor devuelto
RtlEnumerateGenericTableWithoutSplayingAvl devuelve un puntero a la estructura definida por el llamador asociada al elemento. Devuelve NULL si restartKey es null y la tabla no tiene elementos o si RestartKey es un puntero devuelto y no hay ningún elemento siguiente.
Observaciones
se puede llamar repetidamente al RtlEnumerateGenericTableWithoutSplayingAvl para procesar los datos del autor de la llamada en cada elemento de una tabla genérica.
Los elementos se devuelven en el orden devuelto es tal como se define en el parámetro PRTL_AVL_COMPARE_ROUTINE proporcionado a RtlInitializeGenericTableAvl.
De forma predeterminada, el sistema operativo usa árboles de reproducción para implementar tablas genéricas, pero la RtlLookupElementGenericTableFullAvl rutina solo funciona con árboles Adelson-Velsky/Landis (AVL). Para 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 de RtlEnumerateGenericTableWithoutSplayingAv l en lugar de RtlEnumerateGenericTableWithoutSplaying. En la llamada a RtlEnumerateGenericTableWithoutSplayingAvl, el autor de la llamada debe pasar una estructura de tabla de RTL_AVL_TABLE en lugar de RTL_GENERIC_TABLE.
Llamadores de la* Rtl.. Las rutinas GenericTableAvl* son responsables de sincronizar exclusivamente el acceso a la tabla genérica. Una exclusión mutua rápida exclusiva es el mecanismo de sincronización más eficaz que se usará para este propósito.
Los autores de llamadas de RtlEnumerateGenericTableWithoutSplayingAvl deben ejecutarse en IRQL < DISPATCH_LEVEL si se puede paginar la memoria asignada por el autor de la llamada para la tabla genérica.
Requisitos
| Requisito | Valor |
|---|---|
| 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 | Consulte la sección Comentarios. |