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 例程會釋放與所提供 CallbackData 對象相關聯的任何 MDL 鏈結。呼叫該物件的 FltFreeCallbackData 之後，與FLT_CALLBACK_DATA對象相關聯的 MDL 鏈結指標將會無效。