Makro FsRtlSetupAdvancedHeaderEx (ntifs.h)
Makro FsRtlSetupAdvancedHeaderEx digunakan oleh sistem file untuk menginisialisasi struktur FSRTL_ADVANCED_FCB_HEADER untuk digunakan dengan konteks aliran dan file.
Sintaks
void FsRtlSetupAdvancedHeaderEx(
_advhdr,
_fmutx,
_fctxptr
);
Parameter
_advhdr
Arahkan ke struktur FSRTL_ADVANCED_FCB_HEADER yang akan diinisialisasi.
_fmutx
Penunjuk ke mutex cepat yang diinisialisasi yang akan digunakan untuk menyinkronkan akses ke anggota FSRTL_ADVANCED_FCB_HEADER tertentu. Mutex cepat harus dialokasikan dari kumpulan yang tidak disebarkan. Parameter ini bersifat opsional dan dapat berupa 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 struktur FSRTL_ADVANCED_FCB_HEADER , yang terkandung dalam objek konteks aliran, untuk menunjuk ke mutex cepat yang ada. (Ini dapat dilakukan sebelum atau sesudah memanggil FsRtlSetupAdvancedHeaderEx.)
_fctxptr
Penunjuk ke bidang penunjuk yang digunakan oleh pustaka runtime sistem file (FSRTL) untuk melacak konteks file. Parameter ini bersifat opsional dan dapat berupa NULL. Secara khusus:
Untuk sistem operasi Microsoft Windows yang dirilis sebelum Windows Vista, penelepon harus mengatur parameter ini ke NULL.
Untuk sistem operasi Windows yang dimulai dengan Windows Vista: Jika FileContextSupportPointer bukan NULL, FileContextSupportPointer harus menjadi penunjuk ke variabel PVOID di dalam struktur per file untuk sistem file yang membuat struktur. Untuk menunjukkan bahwa driver sistem file tidak mendukung konteks file, pemanggil harus mengatur FileContextSupportPointer ke NULL.
Nilai kembali
Tidak ada
Keterangan
Sistem file menggunakan makro FsRtlSetupAdvancedHeaderEx untuk menginisialisasi struktur FSRTL_ADVANCED_FCB_HEADER untuk digunakan dengan konteks aliran dan file.
Ketika struktur header FCB tingkat lanjut tidak lagi diperlukan, sistem file harus memanggil FsRtlTeardownPerStreamContexts untuk membebaskan semua aliran terkait dan struktur konteks file.
Untuk informasi selengkapnya, lihat Melacak konteks Per-Stream dalam Driver Filter Sistem File Warisan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Pembaruan Rollup untuk Microsoft Windows 2000 Service Pack 4 (SP4); Windows XP |
| Target Platform | Desktop |
| Header | ntifs.h (termasuk Ntifs.h, Fltkernel.h) |
| IRQL | PASSIVE_LEVEL |
Lihat juga
FsRtlGetPerStreamContextPointer