Função FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlInitExtraCreateParameterLookasideList inicializa uma lista lookaside de pool paginada ou não paga 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 FsRtlInitExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

Parâmetros

[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ãopagada, a estrutura cabeçalho da lista deve ser alocada do pool nãopagado.

[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, FsRtlInitExtraCreateParameterLookasideList inicializará uma lista lookaside para entradas ECP não pagas do tamanho especificado. Caso contrário, FsRtlInitExtraCreateParameterLookasideList 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 paginada ou nãopagada. Use a rotina FsRtlAllocateExtraCreateParameterFromLookasideList para alocar um ECP da lista lookaside e a rotina FsRtlFreeExtraCreateParameter para retornar um buffer ECP à lista lookaside para reciclagem.

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

Os drivers devem liberar todos os ECPs e listas lookaside que eles criam 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 FsRtlInitExtraCreateParameterLookasideList está disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL