Función ExFreeToPagedLookasideList (wdm.h)

La rutina ExFreeToPagedLookasideList devuelve una entrada paginable a la lista de lookaside especificada o al grupo paginado.

Sintaxis

void ExFreeToPagedLookasideList(
  [in, out] PPAGED_LOOKASIDE_LIST Lookaside,
  [in]      PVOID                 Entry
);

Parámetros

[in, out] Lookaside

Puntero a la estructura PAGED_LOOKASIDE_LIST de la lista de lookaside, que el llamador ya inicializó con ExInitializePagedLookasideList, que el autor de la llamada ya inicializó con ExInitializePagedLookasideList.

[in] Entry

Puntero a la entrada que se va a liberar. El autor de la llamada obtuvo este puntero de una llamada anterior a ExAllocateFromPagedLookasideList.

Valor devuelto

None

Observaciones

Precaución

A partir de Windows 11, versión 22H2, esta función cambió de insertada a exportada. Como resultado, si compila el controlador destinado a la versión más reciente de Windows, no se cargará en versiones anteriores del sistema operativo. Para cambiar la versión del sistema operativo de destino en Visual Studio, seleccione Propiedades de configuración-Configuración-Configuración> del controlador-General>.

ExFreeToPagedLookasideList es el mutuo de ExAllocateFromPagedLookasideList. Libera una entrada asignada por el autor de la llamada a la lista de búsqueda del autor de la llamada o al grupo paginado cuando esa entrada ya no está en uso.

La misma entrada se puede reasignar u otra entrada se puede asignar más adelante con una llamada posterior a ExAllocateFromPagedLookasideList. El usuario de una lista de lookaside puede asignar y liberar estas entradas dinámicamente, según sea necesario, hasta que llame a ExDeletePagedLookasideList. ExDeletePagedLookasideList libera todas las entradas pendientes de la lista antes de borrar el estado del sistema para la lista de lookaside especificada y devuelve el control.

Si la lista de lookaside especificada aún no ha alcanzado el número máximo de entradas determinada por el sistema, ExFreeToPagedLookasideList inserta la entrada especificada en la parte delantera de la lista. De lo contrario, el búfer en Entry se libera de nuevo al grupo paginado mediante la rutina Free proporcionada por el autor de la llamada, si existe, que se configuró cuando se inicializó la lista de lookaside o ExFreePool.

En Windows 2000, los controladores deben usar el modificador -D_WIN2K_COMPAT_SLIST_USAGE para vincular correctamente el código que usa ExFreeToPagedLookasideList.

Para obtener más información, consulte Uso de lookaside Listas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte también

ExAllocateFromPagedLookasideList

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST