Partilhar via


Função FltFreeCallbackData (fltkernel.h)

A rotina FltFreeCallbackData libera uma estrutura de dados de retorno de chamada alocada pela rotina de 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.

Valor de retorno

Nenhum

Observações

Um driver de minifiltro deve usar FltFreeCallbackData somente em uma estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA) que ele alocou anteriormente com FltAllocateCallbackData e usado 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 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.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho fltkernel.h (inclua Fltkernel.h)
biblioteca FltMgr.lib
IRQL <= DISPATCH_LEVEL

Consulte também

FLT_CALLBACK_DATA

FltAllocateCallbackData

FltPerformAsynchronousIo

FltPerformSynchronousIo

FltReuseCallbackData