PFLT_NORMALIZE_CONTEXT_CLEANUP fonction de rappel (fltkernel.h)

Article
03/05/2024

Un pilote minifilter qui fournit des noms de fichiers pour le cache de noms du gestionnaire de filtres peut inscrire une routine de type PFLT_NORMALIZE_CONTEXT_CLEANUP en tant que routine NormalizeContextCleanupCallback du pilote minifilter.

Syntaxe

PFLT_NORMALIZE_CONTEXT_CLEANUP PfltNormalizeContextCleanup;

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

Paramètres

[in, optional] NormalizationContext

Pointeur vers les informations de contexte fournies par le pilote minifilter à passer dans tous les appels à la routine de rappel PFLT_NORMALIZE_NAME_COMPONENT qui sont effectués pour normaliser plusieurs composants dans le même chemin de nom de fichier.

Valeur de retour

None

Remarques

Pour inscrire cette routine de rappel, le pilote minifilter stocke l’adresse d’une routine de type PFLT_NORMALIZE_CONTEXT_CLEANUP dans le membre NormalizeContextCleanupCallback de la structure FLT_REGISTRATION que le pilote minifilter transmet en tant que paramètre à FltRegisterFilter.

Le gestionnaire de filtres appelle cette routine de rappel pour permettre au pilote minifilter d’effectuer tout nettoyage nécessaire pour les informations de contexte passées dans le paramètre NormalizationContext de la routine de rappel PFLT_NORMALIZE_NAME_COMPONENT . Ce contexte est défini par le pilote minifilter lorsque sa routine de rappel PFLT_NORMALIZE_NAME_COMPONENT est appelée.