Función FltFreeCallbackData (fltkernel.h)

Artículo
02/26/2024

La rutina FltFreeCallbackData libera una estructura de datos de devolución de llamada asignada por la rutina FltAllocateCallbackData .

Sintaxis

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parámetros

[in] CallbackData

Puntero a la estructura de datos de devolución de llamada que se va a liberar. Esta estructura FLT_CALLBACK_DATA debe haber sido asignada por una llamada anterior a FltAllocateCallbackData. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

None

Observaciones

Un controlador de minifiltro debe usar FltFreeCallbackData solo en una estructura de datos de devolución de llamada (FLT_CALLBACK_DATA) asignada previamente con FltAllocateCallbackData y usada en una llamada a FltPerformAsynchronousIo o FltPerformSynchronousIo.

En concreto, un controlador de minifiltro no debe usar esta rutina para ninguna estructura de datos de devolución de llamada que no haya asignado el propio controlador de minifiltro.

La rutina FltFreeCallbackData libera cualquier cadena MDL asociada al objeto CallbackData proporcionado. Un puntero a una cadena MDL asociada a un objeto FLT_CALLBACK_DATA no será válido después de una llamada a FltFreeCallbackData para ese objeto.