Fungsi FltFreeCallbackData (fltkernel.h)
Rutinitas FltFreeCallbackData membebaskan struktur data panggilan balik yang dialokasikan oleh rutinitas FltAllocateCallbackData .
Sintaks
VOID FLTAPI FltFreeCallbackData(
[in] PFLT_CALLBACK_DATA CallbackData
);
Parameter
[in] CallbackData
Arahkan ke struktur data panggilan balik yang akan dibebaskan. Struktur FLT_CALLBACK_DATA ini harus dialokasikan oleh panggilan sebelumnya ke FltAllocateCallbackData. Parameter ini diperlukan dan tidak boleh NULL.
Nilai kembali
Tidak ada
Keterangan
Driver minifilter harus menggunakan FltFreeCallbackData hanya pada struktur data panggilan balik (FLT_CALLBACK_DATA) yang sebelumnya dialokasikan dengan FltAllocateCallbackData dan digunakan dalam panggilan ke FltPerformAsynchronousIo atau FltPerformSynchronousIo.
Secara khusus, driver minifilter tidak boleh menggunakan rutinitas ini untuk struktur data panggilan balik apa pun yang tidak dialokasikan oleh driver minifilter itu sendiri.
Rutinitas FltFreeCallbackData membebaskan rantai MDL apa pun yang terkait dengan objek CallbackData yang disediakan. Penunjuk ke rantai MDL yang terkait dengan objek FLT_CALLBACK_DATA akan tidak valid setelah panggilan ke FltFreeCallbackData untuk objek tersebut.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | fltkernel.h (termasuk Fltkernel.h) |
| Pustaka | FltMgr.lib |
| IRQL | <= DISPATCH_LEVEL |