PFLT_CONTEXT_CLEANUP_CALLBACK función de devolución de llamada (fltkernel.h)

Artículo
03/05/2024

Un controlador de minifiltro puede registrar una rutina de tipo PFLT_CONTEXT_CLEANUP_CALLBACK como rutina contextCleanupCallback del controlador de minifiltro.

Sintaxis

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

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

Parámetros

[in] Context

Puntero a la parte del controlador de minifiltro del contexto.

[in] ContextType

Tipo de contexto. Debe ser uno de los siguientes valores:

FLT_FILE_CONTEXT (a partir de Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (a partir de Windows 8)

FLT_TRANSACTION_CONTEXT (a partir de Windows Vista)

FLT_VOLUME_CONTEXT

Valor devuelto

None

Observaciones

Un controlador de minifiltro puede especificar opcionalmente una rutina de tipo PFLT_CONTEXT_CLEANUP_CALLBACK como rutina contextCleanupCallback del controlador minifiltro para cada tipo de contexto que registra cuando llama a FltRegisterFilter desde su rutina DriverEntry . Para especificar esta rutina, el controlador de minifiltro almacena un puntero a la rutina en el miembro ContextCleanupCallback de la estructura FLT_CONTEXT_REGISTRATION para el tipo de contexto.

Si el controlador de minifiltro especifica una rutina ContextCleanupCallback para un tipo de contexto, el administrador de filtros llama a esta rutina antes de liberar cualquiera de los contextos del controlador de minifiltro de ese tipo. En esta rutina, el controlador de minifiltro realiza cualquier limpieza necesaria, como liberar memoria adicional que el controlador de minifiltro asignó dentro de la estructura de contexto. Una vez que vuelva la rutina ContextCleanupCallback , el administrador de filtros libera el contexto.

Para obtener más información sobre el registro de contexto, consulte la entrada de referencia para FLT_CONTEXT_REGISTRATION.