Função FltFreeCallbackData (fltkernel.h)

Artigo
02/29/2024

A rotina FltFreeCallbackData libera uma estrutura de dados de retorno de chamada alocada pela rotina FltAllocateCallbackData .

Sintaxe

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parâmetros

[in] CallbackData

Ponteiro para a estrutura de dados de retorno de chamada a ser liberada. Essa estrutura FLT_CALLBACK_DATA deve ter sido alocada por uma chamada anterior para FltAllocateCallbackData. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

Nenhum

Comentários

Um driver de minifiltro deve usar FltFreeCallbackData somente em uma estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA) alocada anteriormente com FltAllocateCallbackData e usada em uma chamada para FltPerformAsynchronousIo ou FltPerformSynchronousIo.

Em particular, um driver de minifiltro não deve usar essa rotina para estruturas de dados de retorno de chamada que não foram alocadas pelo próprio driver de minifiltro.

A rotina FltFreeCallbackData libera qualquer cadeia de MDL associada ao objeto CallbackData fornecido. Um ponteiro para uma cadeia de MDL associada a um objeto FLT_CALLBACK_DATA será inválido após uma chamada para FltFreeCallbackData para esse objeto.