Fungsi FltReuseCallbackData (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltReuseCallbackData menginisialisasi ulang struktur data panggilan balik sehingga dapat digunakan kembali.

Sintaks

VOID FLTAPI FltReuseCallbackData(
  [in, out] PFLT_CALLBACK_DATA CallbackData
);

Parameter

[in, out] CallbackData

Arahkan ke struktur data panggilan balik (FLT_CALLBACK_DATA) yang akan digunakan kembali. Struktur ini harus dialokasikan oleh panggilan sebelumnya ke FltAllocateCallbackData. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

Tidak ada

Keterangan

FltReuseCallbackData menginisialisasi ulang struktur data panggilan balik (FLT_CALLBACK_DATA) sehingga dapat digunakan dalam operasi I/O baru. FltReuseCallbackData tidak mengubah bidang TargetInstance atau bidang TargetFileObject dari blok parameter I/O struktur data panggilan balik.

Rutinitas FltReuseCallbackData 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 FltReuseCallbackData untuk objek tersebut.

Menggunakan FltReuseCallbackData untuk menggunakan kembali struktur data panggilan balik lebih cepat daripada membebaskan struktur dan mengalokasikan yang baru.

Driver minifilter harus menggunakan FltReuseCallbackData hanya pada struktur data panggilan balik yang sebelumnya dialokasikan driver minifilter dengan FltAllocateCallbackData dan digunakan dalam panggilan ke FltPerformSynchronousIo atau FltPerformAsynchronousIo.

Jika struktur data panggilan balik digunakan untuk I/O asinkron, driver minifilter tidak boleh memanggil FltReuseCallbackData sampai CallbackRoutine yang ditentukan dalam panggilan ke FltPerformAsynchronousIo dipanggil.

Secara khusus, driver minifilter tidak boleh menggunakan rutinitas ini untuk struktur data panggilan balik apa pun yang tidak dialokasikan oleh driver minifilter itu sendiri.