FsRtlDeleteExtraCreateParameterLookasideList function (ntifs.h)

Article
02/22/2024

The FsRtlDeleteExtraCreateParameterLookasideList routine frees an extra create parameter (ECP) lookaside list.

Syntax

void FsRtlDeleteExtraCreateParameterLookasideList(
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags
);

Parameters

[in, out] Lookaside

Pointer to an opaque PAGED_LOOKASIDE_LIST or NPAGED_LOOKASIDE_LIST lookaside list-head structure that represents the lookaside list to be freed.

[in] Flags

Communicates ECP lookaside list allocation options with which the FsRtlInitExtraCreateParameterLookasideList routine initialized the lookaside list.

This Flags parameter should be the same as the Flags parameter used in the call to the FsRtlInitExtraCreateParameterLookasideList routine.

Return value

None

Remarks

The FsRtlDeleteExtraCreateParameterLookasideList routine frees the ECP lookaside list to which the Lookaside parameter points. However, freeing the lookaside list does not automatically free any ECP context structures allocated from the lookaside list. To free an ECP context structure allocated from a lookaside list, call the FsRtlFreeExtraCreateParameter routine.

Drivers must explicitly free all ECP context structures and ECP lookaside lists that they created before unloading. For more information about using lookaside lists, see Using Lookaside Lists.

Requirements

Requirement	Value
Minimum supported client	FsRtlDeleteExtraCreateParameterLookasideList is available starting with Windows Vista.
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL