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 |