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 lookaside, que el llamador ya inicializó con ExInitializeNPagedLookasideList.

Valor devuelto

ExAllocateFromNPagedLookasideList devuelve un puntero a una entrada si se puede asignar uno. De lo contrario, devuelve NULL.

Observaciones

Si la lista de lookaside especificada 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 Allocate especificada en la inicialización de lista o ExAllocatePoolWithTag para devolver un puntero de entrada.

Después, 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 SRB SCSI, 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, consulte Uso de lookaside Listas.

Requisitos

Consulte también

ExAllocateFromPagedLookasideList

ExFreeToNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST