Edit

Share via

ExFreePoolWithTag function (wdm.h)

  • Article

The ExFreePoolWithTag routine deallocates a block of pool memory allocated with the specified tag.

Syntax

void ExFreePoolWithTag(
  [in] PVOID P,
  [in] ULONG Tag
);

Parameters

[in] P

Specifies the beginning address of a block of pool memory allocated by either ExAllocatePoolWithTag or ExAllocatePoolWithQuotaTag.

[in] Tag

Specifies the tag value passed to ExAllocatePoolWithTag or ExAllocatePoolWithQuotaTag when the block of memory was originally allocated.

The tag is a non-zero character literal of one to four characters delimited by single quotation marks (for example, 'Tag1'). The string is usually specified in reverse order (for example, '1gaT'). Each ASCII character in the tag must be a value in the range 0x20 (space) to 0x7E (tilde). Each allocation code path should use a unique pool tag to help debuggers and verifiers identify the code path.

Return value

None

Remarks

Callers of ExFreePoolWithTag must be running at IRQL <= DISPATCH_LEVEL. A caller at DISPATCH_LEVEL must have specified a NonPagedXxxPoolType when the memory was allocated. Otherwise, the caller must be running at IRQL <= APC_LEVEL.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (see Remarks section)
DDI compliance rules IrqlExFree1(wdm), IrqlExFree2(wdm), IrqlExFree3(wdm)

See also

ExAllocatePoolWithQuotaTag

ExAllocatePoolWithTag

ExFreePool