Función FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Artículo
12/21/2024

La FsRtlInitExtraCreateParameterLookasideList rutina inicializa una lista de búsqueda de grupo paginada o no paginada que se usa para la asignación de una o varias estructuras de contexto de parámetros adicionales de creación (ECP) de tamaño fijo.

Sintaxis

void FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parámetros

[in, out] Lookaside

Puntero a un PAGED_LOOKASIDE_LIST opaco o NPAGED_LOOKASIDE_LIST estructura de la cabeza de lista de aspecto. Para una lista de lookaside paginada o no paginada, la estructura de encabezado de lista debe asignarse desde un grupo no paginado.

[in] Flags

Define las opciones de asignación del grupo. Si el parámetro Flags contiene el valor de marca de bits de FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, FsRtlInitExtraCreateParameterLookasideList inicializa una lista de lookaside para entradas ECP no paginadas del tamaño especificado. De lo contrario, FsRtlInitExtraCreateParameterLookasideList inicializa una lista de lookaside para las entradas ECP paginadas del tamaño especificado.

[in] Size

Especifica el tamaño, en bytes, para todas las entradas ECP de la lista de lookaside.

[in] Tag

Especifica la etiqueta de grupo que se va a usar al asignar entradas ECP de lista de lookaside. Para obtener más información sobre las etiquetas de grupo, consulte el parámetro tag de ExAllocatePoolWithTag.

Valor devuelto

Ninguno

Observaciones

Use esta rutina para inicializar una lista de lookaside de grupo paginada o no paginada. Use la rutina de FsRtlAllocateExtraCreateParameterFromLookasideList para asignar un ECP de la lista de lookaside y la rutina de FsRtlFreeExtraCreateParameter para devolver un búfer ECP a la lista de lookaside para su reciclaje.

Use la rutina FsRtlDeleteExtraCreateParameterLookasideList para liberar la propia lista de lookaside.

Los controladores deben liberar todas las ECP y listas de búsqueda que crean antes de descargarlas.

Para obtener más información sobre el uso de listas de lookaside con controladores, consulte Using Lookaside Lists.

Requisitos

Requisito	Valor
cliente mínimo admitido	La rutina FsRtlInitExtraCreateParameterLookasideList está disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL