ExFreeToLookasideListEx routine

The ExFreeToLookasideListEx routine inserts an entry into a lookaside list, or, if the list is full, frees the allocated storage for the entry.

Syntax


VOID ExFreeToLookasideListEx(
  _Inout_ PLOOKASIDE_LIST_EX Lookaside,
  _In_    PVOID              Entry
);

Parameters

Lookaside [in, out]

A pointer to a LOOKASIDE_LIST_EX structure that describes a lookaside list. This structure was previously initialized by the ExInitializeLookasideListEx routine.

Entry [in]

A pointer to the lookaside-list entry that is being freed.

Return value

None

Remarks

This routine frees a lookaside-list entry that was allocated by a previous call to the ExAllocateFromLookasideListEx routine. ExFreeToLookasideListEx inserts the entry into the specified lookaside list, if space for the entry is available in the list. If the list is full (that is, it already contains the maximum number of entries, as determined by the operating system), ExFreeToLookasideListEx calls the LookasideListFreeEx routine to free the storage for the specified entry, if the driver has provided such a routine. Otherwise, a default deallocation routine is used to free the entry.

For more information about lookaside lists, see Using Lookaside Lists.

Requirements

Target platform

Version

Available in Windows Vista and later versions of Windows.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= DISPATCH_LEVEL

See also

ExAllocateFromLookasideListEx
ExInitializeLookasideListEx
LOOKASIDE_LIST_EX

 

 

Send comments about this topic to Microsoft

Show: