Función ExAllocateFromNPagedLookasideList (wdm.h)
La rutina ExAllocateFromNPagedLookasideList devuelve un puntero a una entrada no paginada de la lista de lookaside especificada o devuelve un puntero a una entrada no paginada recién asignada.
Sintaxis
PVOID ExAllocateFromNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);
Parámetros
[in, out] Lookaside
Puntero a la estructura NPAGED_LOOKASIDE_LIST de la lista de búsqueda, que el autor de la llamada ya inicializó con ExInitializeNPagedLookasideList.
Valor devuelto
ExAllocateFromNPagedLookasideList devuelve un puntero a una entrada si se puede asignar uno. De lo contrario, devuelve NULL.
Observaciones
Cautela
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 del controlador->General.
Si la lista de búsqueda dada no está vacía, ExAllocateFromNPagedLookasideList quita la primera entrada de la lista y devuelve un puntero a esta entrada. De lo contrario, ExAllocateFromNPagedLookasideList llama a la rutina Asignar especificada en la inicialización de lista o exAllocatePoolWithTag para devolver un puntero de entrada.
A continuación, el autor de la llamada puede configurar la entrada devuelta con cualquier dato determinado por el autor de la llamada. Por ejemplo, un controlador podría usar cada entrada de tamaño fijo para configurar bloques de comandos, como SCSI SRB, en dispositivos periféricos en un tipo determinado de bus de E/S. El autor de la llamada debe liberar cada entrada con ExFreeToNPagedLookasideList cuando ya no esté en uso.
Para obtener más información, vea Using Lookaside Lists.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL |
Consulte también
ExAllocateFromPagedLookasideList