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

Artigo
03/01/2024

Um minifiltro pode registrar uma rotina do tipo PFLT_CONTEXT_FREE_CALLBACK como a rotina ContextFreeCallback do driver de minifiltro.

Sintaxe

PFLT_CONTEXT_FREE_CALLBACK PfltContextFreeCallback;

void PfltContextFreeCallback(
  [in] PVOID Pool,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

Parâmetros

[in] Pool

Um ponteiro para o contexto a ser liberado.

[in] ContextType

O tipo de contexto. Esse parâmetro é necessário e deve ser um dos seguintes valores:

FLT_FILE_CONTEXT (começando pelo Windows Vista)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (começando com Windows 8)

FLT_TRANSACTION_CONTEXT (começando pelo Windows Vista)

FLT_VOLUME_CONTEXT

Retornar valor

Nenhum

Comentários

Para os casos raros em que um driver de minifiltro deve liberar seus próprios contextos manualmente, o driver de minifiltro pode especificar uma rotina do tipo PFLT_CONTEXT_FREE_CALLBACK como a rotina ContextFreeCallback 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 ContextFreeCallback da estrutura FLT_CONTEXT_REGISTRATION para o tipo de contexto.

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