Fungsi FsRtlInsertPerFileObjectContext (ntifs.h)

Artikel
02/26/2024

Untuk driver filter sistem file "warisan", fungsi FsRtlInsertPerFileObjectContext mengaitkan informasi konteks dengan objek file.

Sintaks

NTSTATUS FsRtlInsertPerFileObjectContext(
  [in] PFILE_OBJECT                  FileObject,
  [in] PFSRTL_PER_FILEOBJECT_CONTEXT Ptr
);

Parameter

[in] FileObject

Penunjuk ke objek file untuk mengaitkan informasi konteks (diberikan oleh parameter Ptr ).

[in] Ptr

Penunjuk ke struktur FSRTL_PER_FILEOBJECT_CONTEXT yang dialokasikan pemanggil dan diinisialisasi untuk dikaitkan dengan FileObject. Struktur dapat digunakan apa adanya atau disematkan dalam struktur informasi konteks per objek yang ditentukan driver. Untuk menginisialisasi struktur, gunakan makro FsRtlInitPerFileObjectContext .

Nilai kembali

FsRtlInsertPerFileObjectContext mengembalikan nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Struktur informasi konteks berhasil dikaitkan dengan objek file.
STATUS_INVALID_PARAMETER	Parameter FileObject adalah NULL.
STATUS_INSUFFICIENT_RESOURCES	Sistem tidak memiliki sumber daya yang memadai untuk menyelesaikan operasi. Misalnya, ekstensi objek file tidak dapat dialokasikan untuk FileObject.

Keterangan

Driver filter sistem file memanggil FsRtlInsertPerFileObjectContext untuk mengaitkan struktur konteks per-file-object sendiri dengan objek file. Struktur konteks berisi informasi konteks yang dipertahankan driver filter untuk objek file. Fungsi FsRtlInsertPerStreamContext menyisipkan struktur konteks Ptr ke dalam daftar konteks untuk FileObject.

Semua struktur informasi konteks per file-objek harus atau berisi struktur FSRTL_PER_FILEOBJECT_CONTEXT yang diinisialisasi. Gunakan makro FsRtlInitPerFileObjectContext untuk menginisialisasi struktur FSRTL_PER_FILEOBJECT_CONTEXT.

Setelah struktur FSRTL_PER_FILEOBJECT_CONTEXT atau struktur konteks per objek yang ditentukan filter (berisi struktur FSRTL_PER_FILEOBJECT_CONTEXT yang diinisialisasi) telah dikaitkan dengan objek file, struktur tersebut dapat diambil dengan memanggil FsRtlLookupPerFileObjectContext atau dihapus dengan memanggil FsRtlRemovePerFileObjectContext.

Catatan Driver minifilter sistem file tidak boleh menggunakan fungsi FsRtlXxxPerFileObjectContext . Sebagai gantinya, minifilter dapat menggunakan fungsi Konteks FltXxx untuk mengaitkan informasi konteks dengan objek file. Untuk daftar lengkapnya, lihat topik FSRTL_PER_FILEOBJECT_CONTEXT .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Universal
Header	ntifs.h (termasuk Fltkernel.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Lihat juga

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext

Bagikan melalui