PFLT_CONTEXT_CLEANUP_CALLBACK fonction de rappel (fltkernel.h)

Article
02/06/2025

Un pilote minifilter peut inscrire une routine de type PFLT_CONTEXT_CLEANUP_CALLBACK comme routine ContextCleanupCallback du pilote minifilter.

Syntaxe

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

void PfltContextCleanupCallback(
  [in] PFLT_CONTEXT Context,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

Paramètres

[in] Context

Pointeur vers la partie du pilote minifilter du contexte.

[in] ContextType

Type de contexte. Doit être l’une des valeurs suivantes :

FLT_FILE_CONTEXT (à partir de Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (à partir de Windows 8)

FLT_TRANSACTION_CONTEXT (à partir de Windows Vista)

FLT_VOLUME_CONTEXT

Valeur de retour

Aucun

Remarques

Un pilote minifilter peut éventuellement spécifier une routine de type PFLT_CONTEXT_CLEANUP_CALLBACK comme routine ContextCleanupCallback du pilote minifilter pour chaque type de contexte qu’il inscrit lorsqu’il appelle FltRegisterFilter à partir de sa routine DriverEntry. Pour spécifier cette routine, le pilote minifilter stocke un pointeur vers la routine dans la ContextCleanupCallback membre de la structure FLT_CONTEXT_REGISTRATION pour le type de contexte.

Si le pilote minifilter spécifie une routine ContextCleanupCallback pour un type de contexte, le gestionnaire de filtre appelle cette routine avant de libérer les contextes du pilote minifilter de ce type. Dans cette routine, le pilote minifilter effectue tout nettoyage nécessaire, par exemple libérer de la mémoire supplémentaire allouée par le pilote minifilter à l’intérieur de la structure de contexte. Une fois la routine ContextCleanupCallback retournée, le gestionnaire de filtres libère le contexte.

Pour plus d’informations sur l’inscription de contexte, consultez l’entrée de référence pour FLT_CONTEXT_REGISTRATION.