Edit

NdisFreeMemoryWithTag function (ndis.h)

  • Article

The NdisFreeMemoryWithTag function is deprecated for all NDIS versions. Use NdisAllocateMemoryWithTagPriority instead.

Syntax

void NdisFreeMemoryWithTag(
  [in] IN PVOID VirtualAddress,
  [in] IN ULONG Tag
);

Parameters

[in] VirtualAddress

A pointer to the base virtual address of the allocated memory. This address was returned by the NdisAllocateMemoryWithTag function.

[in] Tag

A string, delimited by single quotation marks, with up to four characters, usually specified in reversed order. The NDIS-supplied default tag for this call is 'maDN', but the caller can override this default by supplying an explicit value.

Return value

None

Remarks

Because noncached memory and contiguous memory are seldom released until the allocating miniport driver is unloading, a caller of NdisFreeMemoryWithTag usually is running at IRQL = PASSIVE_LEVEL for these types of de-allocations. In any case:

  • When a caller of NdisFreeMemoryWithTag releases contiguous memory, it must be running at IRQL = PASSIVE_LEVEL.
  • When a caller of NdisFreeMemoryWithTag releases noncached memory, it must be running at IRQL < DISPATCH_LEVEL.
  • When a caller of NdisFreeMemoryWithTag releases memory that is neither contiguous nor noncached, it must be running at IRQL <= DISPATCH_LEVEL.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.20 and later.
Target Platform Universal
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL See Remarks section.

See also

NdisAllocateMemoryWithTag