Função FsRtlInitExtraCreateParameterLookasideList (ntifs.h)

Artigo
03/01/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 list-head 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ãopagadas 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.

Retornar valor

Nenhum

Comentários

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 Using Lookaside Listas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A rotina FsRtlInitExtraCreateParameterLookasideList está disponível a partir do Windows Vista.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL