PFLT_CONTEXT_CLEANUP_CALLBACK fonction de rappel (fltkernel.h)

Article
03/01/2024

Un pilote minifilter peut inscrire une routine de type PFLT_CONTEXT_CLEANUP_CALLBACK en tant que 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. Il doit s’agir de l’une des valeurs suivantes :

FLT_FILE_CONTEXT (à partir de Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (à compter de Windows 8)

FLT_TRANSACTION_CONTEXT (à partir de Windows Vista)

FLT_VOLUME_CONTEXT

Valeur de retour

None

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 le membre ContextCleanupCallback 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 filtres 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 en libérant 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 contextuelle, consultez l’entrée de référence pour FLT_CONTEXT_REGISTRATION.