Función FltInitExtraCreateParameterLookasideList (fltkernel.h)

Artículo
02/06/2025

El FltInitExtraCreateParameterLookasideList rutina inicializa una lista de lookaside de grupo paginada o no paginada que se usa para la asignación de una o varias estructuras de contexto de parámetro de creación adicional (ECP) de tamaño fijo.

Sintaxis

VOID FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parámetros

[in] Filter

Puntero de filtro opaco al controlador de minifiltro. Este puntero identifica de forma única el controlador de minifiltro y permanece constante siempre que se cargue el controlador de minifiltro.

[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 FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, la rutina inicializa una lista de lookaside para entradas ECP no paginadas del tamaño especificado. De lo contrario, la rutina inicializa una lista de aspecto 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 FltAllocateExtraCreateParameterFromLookasideList para asignar un ECP de la lista de lookaside y la rutina FltFreeExtraCreateParameter para devolver un búfer ECP a la lista de búsqueda para su reciclaje.

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

Los controladores deben liberar todas las ECP y listas de lookaside que crearon antes de descargar.

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 FltInitExtraCreateParameterLookasideList está disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL