PFLT_CONTEXT_CLEANUP_CALLBACK função de retorno de chamada (fltkernel.h)

Artigo
02/06/2025

Um driver de minifiltro pode registrar uma rotina do tipo PFLT_CONTEXT_CLEANUP_CALLBACK como rotina de contextCleanupCallback do driver de minifiltro.

Sintaxe

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

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

Parâmetros

[in] Context

Um ponteiro para a parte do driver de minifiltro do contexto.

[in] ContextType

O tipo de contexto. Deve ser um dos seguintes valores:

FLT_FILE_CONTEXT (começando com o Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (começando com o Windows 8)

FLT_TRANSACTION_CONTEXT (começando com o Windows Vista)

FLT_VOLUME_CONTEXT

Valor de retorno

Nenhum

Observações

Opcionalmente, um driver de minifiltro pode especificar uma rotina de tipo PFLT_CONTEXT_CLEANUP_CALLBACK como a rotina de ContextCleanupCallback do driver de minifiltro para cada tipo de contexto que ele registra quando chama FltRegisterFilter de sua rotina de DriverEntry. Para especificar essa rotina, o driver de minifiltro armazena um ponteiro para a rotina no ContextCleanupCallback membro da estrutura FLT_CONTEXT_REGISTRATION para o tipo de contexto.

Se o driver de minifiltro especificar um ContextCleanupCallback rotina para um tipo de contexto, o gerenciador de filtros chamará essa rotina antes de liberar qualquer um dos contextos do driver de minifiltro desse tipo. Nessa rotina, o driver de minifiltro executa qualquer limpeza necessária, como liberar memória adicional que o driver de minifiltro alocou dentro da estrutura de contexto. Depois que o ContextCleanupCallback rotina retorna, o gerenciador de filtros libera o contexto.

Para obter mais informações sobre o registro de contexto, consulte a entrada de referência para FLT_CONTEXT_REGISTRATION.