Fungsi FsRtlInsertPerStreamContext (ntifs.h)

Artikel
02/27/2024

Rutinitas FsRtlInsertPerStreamContext mengaitkan struktur konteks per aliran driver filter sistem file dengan aliran file.

Sintaks

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

Parameter

PerStreamContext

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

[in] Ptr

Penunjuk ke struktur FSRTL_PER_STREAM_CONTEXT yang telah dialokasikan dan diinisialisasi oleh driver filter. Untuk menginisialisasi struktur ini, gunakan makro FsRtlInitPerStreamContext .

Nilai kembali

FsRtlInsertPerStreamContext mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Panggilan ke FsRtlInsertPerStreamContext berhasil.
STATUS_INVALID_DEVICE_REQUEST	Sistem file yang mendasar tidak mendukung konteks filter.

Keterangan

Driver filter sistem file memanggil FsRtlInsertPerStreamContext untuk mengaitkan struktur konteks per alirannya sendiri dengan aliran file. Struktur konteks per aliran berisi informasi konteks yang dikelola driver filter untuk aliran file.

Setelah struktur konteks per aliran dikaitkan dengan aliran file, struktur tersebut dapat diambil dengan memanggil FsRtlLookupPerStreamContext atau dihapus dengan memanggil 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	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL