Fungsi FltRetainSwappedBufferMdlAddress (fltkernel.h)

Artikel
02/29/2024

FltRetainSwappedBufferMdlAddress mencegah Manajer Filter membebaskan daftar deskriptor memori (MDL) untuk buffer yang ditukar oleh driver minifilter.

Sintaks

void FltRetainSwappedBufferMdlAddress(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parameter

[in] CallbackData

Arahkan ke struktur data panggilan balik untuk operasi.

Nilai kembali

Tidak ada

Keterangan

Ketika driver minifilter bertukar di buffer baru dalam rutinitas panggilan balik praoperasi (PFLT_PRE_OPERATION_CALLBACK), Filter Manager secara otomatis membebaskan MDL buffer ketika rutinitas panggilan balik postoperasi (PFLT_POST_OPERATION_CALLBACK) yang sesuai kembali.

Driver minifilter dapat mencegah Manajer Filter membebaskan MDL dengan memanggil FltRetainSwappedBufferMdlAddress dari rutinitas panggilan balik pascaoperasi.

Setelah memanggil FltRetainSwappedBufferMdlAddress, pemanggil bertanggung jawab untuk membebaskan MDL dengan memanggil rutinitas seperti IoFreeMdl.

FltRetainSwappedBufferMdlAddress hanya dapat dipanggil dari rutinitas panggilan balik pascaoperasi.