RxNameCacheFinalize function (namcache.h)

Article
02/22/2024

RxNameCacheFinalize releases the storage for all of the NAME_CACHE entries associated with a NAME_CACHE_CONTROL structure.

Syntax

void RxNameCacheFinalize(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl
);

Parameters

[in] NameCacheCtl

A pointer to the NAME_CACHE_CONTROL structure for the name cache.

Return value

None

Remarks

The RxNameCacheFinalize routine acquires the lock on the name cache to scan the free list and remove entries from the active list.

On checked builds, this routine causes the system to ASSERT if after releasing all of the active and free entries a reference count still remains on the name cache. This indicates a memory leak where some caller did not call RxNameCacheFreeEntry when done with an entry.

Requirements

Requirement	Value
Target Platform	Desktop
Header	namcache.h (include Namcache.h)
IRQL	<= APC_LEVEL