Função FltInitExtraCreateParameterLookasideList (fltkernel.h)

Artigo
03/01/2024

A rotina FltInitExtraCreateParameterLookasideList inicializa uma lista lookaside de pool paginada ou não paginada 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 enquanto o driver de minifiltro é 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 list-head deve ser alocada do pool não paginado.

[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.

Retornar valor

Nenhum

Comentários

Use essa rotina para inicializar uma lista lookaside de pool paginada 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 Using Lookaside Listas.

Requisitos

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