Fungsi FsRtlSetupAdvancedHeader (ntifs.h)

Artikel
03/01/2024

Makro FsRtlSetupAdvancedHeader digunakan oleh sistem file untuk menginisialisasi struktur FSRTL_ADVANCED_FCB_HEADER untuk digunakan dengan konteks filter.

Sintaks

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Parameter

AdvHdr

Penunjuk ke struktur FSRTL_ADVANCED_FCB_HEADER yang akan diinisialisasi.

FMutex

Penunjuk ke mutex cepat yang diinisialisasi yang akan digunakan untuk menyinkronkan akses ke struktur FSRTL_ADVANCED_FCB_HEADER . Mutex cepat harus dialokasikan dari kumpulan yang tidak disebarkan.

Parameter ini bisa NULL. Penelepon harus mengatur parameter ini ke NULL jika mereka berniat menggunakan objek mutex cepat yang sudah ada. Jika FastMutexADALAH NULL, pemanggil harus secara eksplisit mengatur anggota FastMutex dari objek konteks aliran untuk menunjuk ke mutex cepat yang ada. (Ini dapat dilakukan sebelum atau sesudah memanggil FsRtlSetupAdvancedHeader.)

Nilai kembali

Tidak ada

Keterangan

Sistem file menggunakan makro FsRtlSetupAdvancedHeader untuk menginisialisasi struktur FSRTL_ADVANCED_FCB_HEADER untuk digunakan dengan konteks filter.

Ketika struktur header FCB tingkat lanjut tidak lagi diperlukan, sistem file harus memanggil FsRtlTeardownPerStreamContexts untuk membebaskan semua struktur konteks per aliran terkait.

Untuk informasi selengkapnya, lihat Melacak konteks Per-Stream dalam Driver Filter Sistem File Warisan.