Função FltInitExtraCreateParameterLookasideList (fltkernel.h)

Artigo
02/06/2025

A rotina FltInitExtraCreateParameterLookasideList inicializa uma lista lookaside de pool de páginas ou não páginas usada para a alocação de uma ou mais estruturas de contexto de parâmetro de criação extra (ECPs) de tamanho fixo.

Sintaxe

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

Ponteiro de filtro opaco para o driver de minifiltro. Esse ponteiro identifica exclusivamente o driver de minifiltro e permanece constante desde que o driver de minifiltro seja carregado.

[in, out] Lookaside

Ponteiro para um PAGED_LOOKASIDE_LIST opaco ou NPAGED_LOOKASIDE_LIST estrutura lookaside list-head. Para uma lista lookaside paginada ou não paginada, a estrutura cabeçalho da lista deve ser alocada do pool não paged.

[in] Flags

Define as opções de alocação do pool. Se o parâmetro Flags contiver o valor do sinalizador de bit FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL, a rotina inicializará uma lista lookaside para entradas ECP não paginadas do tamanho especificado. Caso contrário, a rotina inicializa uma lista lookaside para entradas ECP paginadas do tamanho especificado.

[in] Size

Especifica o tamanho, em bytes, para todas as entradas ECP na lista lookaside.

[in] Tag

Especifica a marca de pool a ser usada ao alocar entradas ECP da lista lookaside. Para obter mais informações sobre marcas de pool, consulte o parâmetro Tag de ExAllocatePoolWithTag.

Valor de retorno

Nenhum

Observações

Use essa rotina para inicializar uma lista lookaside de pool de páginas ou não paginada. Use a rotina FltAllocateExtraCreateParameterFromLookasideList para alocar um ECP da lista lookaside e a rotina FltFreeExtraCreateParameter para retornar um buffer ECP à lista lookaside para reciclagem.

Use a rotina FltDeleteExtraCreateParameterLookasideList para liberar a própria lista lookaside.

Os drivers devem liberar todos os ECPs e listas lookaside que eles criaram antes de descarregar.

Para obter mais informações sobre como usar listas lookaside com drivers, consulte Usando listas lookaside.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	A rotina FltInitExtraCreateParameterLookasideList está disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fltkernel.h (inclua Fltkernel.h)
biblioteca	FltMgr.lib
de DLL	Fltmgr.sys
IRQL	<= APC_LEVEL