Функция FltFreeCallbackData (fltkernel.h)
Подпрограмма FltFreeCallbackData освобождает структуру данных обратного вызова, выделенную подпрограммой FltAllocateCallbackData.
Синтаксис
VOID FLTAPI FltFreeCallbackData(
[in] PFLT_CALLBACK_DATA CallbackData
);
Параметры
[in] CallbackData
Указатель на структуру данных обратного вызова, которую необходимо освободить. Эта FLT_CALLBACK_DATA структура должна быть выделена предыдущим вызовом FltAllocateCallbackData. Этот параметр является обязательным и не может быть null.
Возвращаемое значение
Никакой
Замечания
Драйвер мини-фильтра должен использовать FltFreeCallbackData только в структуре данных обратного вызова (FLT_CALLBACK_DATA), которую он ранее выделил с FltAllocateCallbackData и используется в вызове FltPerformAsynchronousIo или FltPerformSynchronousIo.
В частности, драйвер минифильтра не должен использовать эту процедуру для любых структур данных обратного вызова, которые не были выделены самим драйвером минифильтра.
Подпрограмма FltFreeCallbackData освобождает любую цепочку MDL, связанную с предоставленным объектом callbackData CallbackData. Указатель на цепочку MDL, связанную с объектом FLT_CALLBACK_DATA, будет недопустимым после вызова FltFreeCallbackData для этого объекта.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | fltkernel.h (include Fltkernel.h) |
| библиотеки | FltMgr.lib |
| IRQL | <= DISPATCH_LEVEL |