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

Artigo
03/01/2024

Um driver de minifiltro pode registrar uma rotina do tipo PFLT_CONTEXT_CLEANUP_CALLBACK como a rotina 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 pelo Windows 8)

FLT_TRANSACTION_CONTEXT (começando com o Windows Vista)

FLT_VOLUME_CONTEXT

Retornar valor

Nenhum

Comentários

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

Se o driver de minifiltro especificar uma rotina ContextCleanupCallback 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 alocada pelo driver de minifiltro dentro da estrutura de contexto. Depois que a rotina ContextCleanupCallback é retornada, 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.