PFLT_CONTEXT_CLEANUP_CALLBACK funzione di callback (fltkernel.h)

Articolo
02/26/2024

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

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 minifilter 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 minifilter può facoltativamente specificare una routine di tipo PFLT_CONTEXT_CLEANUP_CALLBACK come routine del driver minifilter ContextCleanupCallback per ogni tipo di contesto registrato quando chiama FltRegisterFilter dalla routine DriverEntry . Per specificare questa routine, il driver minifilter archivia un puntatore alla routine nel membro ContextCleanupCallback della struttura di FLT_CONTEXT_REGISTRATION per il tipo di contesto.

Se il driver minifilter specifica una routine ContextCleanupCallback per un tipo di contesto, la gestione filtri chiama questa routine prima di liberare uno dei contesti del driver minifilter di tale tipo. In questa routine, il driver minifilter esegue qualsiasi pulizia necessaria, ad esempio liberando memoria aggiuntiva che il driver minifilter allocato all'interno della struttura del contesto. Dopo aver restituito la routine ContextCleanupCallback , il gestore filtri libera il contesto.

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