Makro FsRtlLookupPerStreamContext (ntifs.h)

Artikel
02/29/2024

Makro FsRtlLookupPerStreamContext mengambil struktur konteks per aliran untuk aliran file.

Sintaks

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Parameter

_sc

Arahkan ke struktur FSRTL_ADVANCED_FCB_HEADER untuk aliran file. Untuk mendapatkan penunjuk ini dari objek file, gunakan makro FsRtlGetPerStreamContextPointer .

_oid

Penunjuk ke variabel yang dialokasikan pemanggil yang secara unik mengidentifikasi pemilik struktur konteks per aliran. Format variabel ini adalah driver filter − spesifik. Harus non-NULL jika nilai non-NULL disediakan untuk InstanceId.

_iid

Pointer ke driver filter − variabel yang dialokasikan yang dapat digunakan untuk membedakan antara struktur konteks per aliran yang dibuat oleh driver filter yang sama. Format variabel ini adalah driver filter − spesifik.

Jika OwnerId dan InstanceId keduanya NULL, FsRtlLookupPerStreamContext mengembalikan konteks pertama per aliran yang ditemukan.

Jika nilai non-NULL disediakan untuk OwnerId dan InstanceId adalah NULL, FsRtlLookupPerStreamContext mengembalikan konteks per aliran pertama yang anggota OwnerId-nya cocok dengan parameter OwnerId .

Nilai kembali

Tidak ada

Keterangan

Driver filter sistem file memanggil FsRtlLookupPerStreamContext untuk mengambil struktur konteks per aliran untuk aliran file. Struktur konteks per aliran berisi informasi konteks yang dikelola driver filter untuk aliran file.

CatatanFsRtlLookupPerStreamContext hanya dapat digunakan pada sistem file yang mendukung konteks per aliran.

Untuk menginisialisasi struktur konteks per aliran, gunakan makro FsRtlInitPerStreamContext .

Untuk mengaitkan struktur konteks per aliran yang diinisialisasi dengan aliran file, panggil FsRtlInsertPerStreamContext.

Untuk menghapus struktur konteks per aliran yang terkait dengan aliran file, panggil FsRtlRemovePerStreamContext.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rollup Pembaruan Windows 2000 SP4; Windows XP
Target Platform	Desktop
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL