PFLT_NORMALIZE_CONTEXT_CLEANUP callback function (fltkernel.h)

Article
02/22/2024

A minifilter driver that provides file names for the filter manager's name cache can register a routine of type PFLT_NORMALIZE_CONTEXT_CLEANUP as the minifilter driver's NormalizeContextCleanupCallback routine.

Syntax

PFLT_NORMALIZE_CONTEXT_CLEANUP PfltNormalizeContextCleanup;

void PfltNormalizeContextCleanup(
  [in, optional] PVOID *NormalizationContext
)
{...}

Parameters

[in, optional] NormalizationContext

Pointer to minifilter driver-provided context information to be passed in any calls to the PFLT_NORMALIZE_NAME_COMPONENT callback routine that are made to normalize multiple components in the same file name path.

Return value

None

Remarks

To register this callback routine, the minifilter driver stores the address of a routine of type PFLT_NORMALIZE_CONTEXT_CLEANUP in the NormalizeContextCleanupCallback member of the FLT_REGISTRATION structure that the minifilter driver passes as a parameter to FltRegisterFilter.

The filter manager calls this callback routine to allow the minifilter driver to perform any needed cleanup for the context information passed in the NormalizationContext parameter of the PFLT_NORMALIZE_NAME_COMPONENT callback routine. This context is set by the minifilter driver when its PFLT_NORMALIZE_NAME_COMPONENT callback routine is called.

Requirements

Requirement	Value
Target Platform	Desktop
Header	fltkernel.h (include Fltkernel.h)
IRQL	PASSIVE_LEVEL