PFLT_CONTEXT_CLEANUP_CALLBACK funzione di callback (fltkernel.h)

Articolo
06/02/2025

Un driver minifilter può registrare una routine di tipo PFLT_CONTEXT_CLEANUP_CALLBACK come routine del driver minifilter ContextCleanupCallback routine.

Sintassi

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

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

Parametri

[in] Context

Puntatore alla parte del driver minifiltro del contesto.

[in] ContextType

Tipo di contesto. Deve essere uno dei valori seguenti:

FLT_FILE_CONTEXT (a partire da Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (a partire da Windows 8)

FLT_TRANSACTION_CONTEXT (a partire da Windows Vista)

FLT_VOLUME_CONTEXT

Valore restituito

Nessuno

Osservazioni

Un driver minifiltro può facoltativamente specificare una routine di tipo PFLT_CONTEXT_CLEANUP_CALLBACK come routine ContextCleanupCallback del driver minifiltro per ogni tipo di contesto registrato quando chiama FltRegisterFilter dalla routine DriverEntry. Per specificare questa routine, il driver minifilter archivia un puntatore alla routine nella ContextCleanupCallback membro della struttura FLT_CONTEXT_REGISTRATION per il tipo di contesto.

Se il driver minifilter specifica un ContextCleanupCallback routine per un tipo di contesto, il gestore filtri chiama questa routine prima di liberare i contesti del driver minifiltro di tale tipo. In questa routine, il driver minifiltro esegue tutte le operazioni di pulizia necessarie, ad esempio liberando memoria aggiuntiva allocata dal driver minifilter all'interno della struttura del contesto. Al termine della routine ContextCleanupCallback, il gestore filtri libera il contesto.

Per altre informazioni sulla registrazione del contesto, vedere la voce di riferimento per FLT_CONTEXT_REGISTRATION.