Fungsi FltGetNewSystemBufferAddress (fltkernel.h)

  • Artikel

Fungsi FltGetNewSystemBufferAddress mengambil buffer AssociatedIrp.SystemBuffer, yang telah dialokasikan sistem file. Rutinitas pasca-panggilan balik driver minifilter memanggil fungsi ini.

Sintaks

PVOID FLTAPI FltGetNewSystemBufferAddress(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parameter

[in] CallbackData

Penunjuk ke struktur FLT_CALLBACK_DATA yang mewakili operasi I/O.

Nilai kembali

Jika buffer AssociatedIrp.SystemBuffer dialokasikan oleh sistem file, FltGetNewSystemBufferAddress mengembalikan pointer ke buffer ini; jika tidak, ia mengembalikan NULL.

Keterangan

Rutinitas pasca-panggilan balik driver minifilter memanggil fungsi FltGetNewSystemBufferAddress untuk mengambil pointer ke buffer AssociatedIrp.SystemBuffer yang telah dialokasikan sistem file. Driver minifilter harus memanggil fungsi ini hanya ketika bendera FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER diatur di CallbackData.Flags.

Ketika sistem file mengalokasikan buffer AssociatedIrp.SystemBuffer sendiri, Filter Manager akan mengatur bendera FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER. Ini menandakan minifilter bahwa buffer yang mereka terima dalam pra-operasi bukan yang memiliki data yang dibaca dari sistem file.

Jika bendera FLTFL_CALLBACK_DATA_NEW_SYSTEM_BUFFER tidak diatur, maka rutinitas ini mengembalikan NULL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka Fltmgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

Lihat juga

FLT_CALLBACK_DATA