Função FltFreeCallbackData (fltkernel.h)
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | fltkernel.h (inclua Fltkernel.h) |
Biblioteca | FltMgr.lib |
IRQL | <= DISPATCH_LEVEL |