Función FltInitExtraCreateParameterLookasideList (fltkernel.h)

Artículo
02/29/2024

La rutina FltInitExtraCreateParameterLookasideList inicializa una lista de búsqueda de grupo paginada o no paginada usada para la asignación de una o varias estructuras de contexto de creación de parámetros adicionales (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 búsqueda 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, 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 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

None

Observaciones

Use esta rutina para inicializar una lista de búsqueda de grupo paginada o no paginada. Use la rutina FltAllocateExtraCreateParameterFromLookasideList para asignar un ECP de la lista de aspecto 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 búsqueda que crearon antes de descargarse.

Para obtener más información sobre el uso de listas de búsqueda con controladores, consulte Uso de lookaside Listas.

Requisitos

Requisito	Value
Cliente mínimo compatible	La rutina FltInitExtraCreateParameterLookasideList está disponible a partir de Windows Vista.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	<= APC_LEVEL