Функция FltFreeCallbackData (fltkernel.h)

  • Статья

Подпрограмма FltFreeCallbackData освобождает структуру данных обратного вызова, выделенную подпрограммой FltAllocateCallbackData .

Синтаксис

VOID FLTAPI FltFreeCallbackData(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Параметры

[in] CallbackData

Указатель на структуру данных обратного вызова, которую необходимо освободить. Эта FLT_CALLBACK_DATA структура должна быть выделена предыдущим вызовом FltAllocateCallbackData. Этот параметр является обязательным и не может иметь значение NULL.

Возвращаемое значение

None

Remarks

Драйвер мини-фильтра должен использовать FltFreeCallbackData только для структуры данных обратного вызова (FLT_CALLBACK_DATA), которая была ранее выделена с помощью FltAllocateCallbackData и использовалась в вызове FltPerformAsynchronousIo или FltPerformSynchronousIo.

В частности, драйвер минифильтра не должен использовать эту подпрограмму для структур данных обратного вызова, которые не были выделены самим драйвером минифильтра.

Подпрограмма FltFreeCallbackData освобождает любую цепочку MDL , связанную с предоставленным объектом CallbackData . Указатель на цепочку MDL, связанную с объектом FLT_CALLBACK_DATA , будет недопустимым после вызова FltFreeCallbackData для этого объекта.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть fltkernel.h (включая Fltkernel.h)
Библиотека FltMgr.lib
IRQL <= DISPATCH_LEVEL

См. также раздел

FLT_CALLBACK_DATA

FltAllocateCallbackData

FltPerformAsynchronousIo

FltPerformSynchronousIo

FltReuseCallbackData