Fungsi FsRtlLookupPerFileObjectContext (ntifs.h)

Artikel
07/11/2023

Untuk driver filter sistem file "warisan", fungsi FsRtlLookupPerFileObjectContext mengambil informasi konteks yang sebelumnya terkait dengan objek file.

Sintaks

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parameter

[in] FileObject

Penunjuk ke objek file untuk mengkueri informasi konteks.

[in, optional] OwnerId

Penunjuk ke variabel yang dialokasikan penelepon yang secara unik mengidentifikasi filter pemilik struktur konteks per file-objek. Format variabel ini khusus untuk filter-driver.

[in, optional] InstanceId

Pointer ke variabel yang dialokasikan penelepon yang dapat digunakan untuk membedakan antara struktur konteks per-file-object yang dibuat oleh driver filter yang sama. Format variabel ini khusus untuk filter-driver. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FsRtlLookupPerFileObjectContext mengembalikan pointer ke konteks per-file-object pertama yang cocok yang ditemukan. Jika tidak ada kecocokan yang ditemukan, FsRtlLookupPerFileObjectContext mengembalikan NULL.

Keterangan

Driver filter sistem file "warisan" memanggil FsRtlLookupPerFileObjectContext untuk mengambil struktur konteks per-file-object untuk objek file. Struktur konteks berisi informasi konteks yang dipertahankan driver filter untuk objek file. Struktur konteks ini sebelumnya harus dikaitkan dengan objek file dengan memanggil fungsi FsRtlInsertPerFileObjectContext .

Jika struktur FSRTL_PER_FILEOBJECT_CONTEXT disematkan dalam struktur konteks filter yang ditentukan per file-objek, makro CONTAINING_RECORD dapat digunakan untuk mendapatkan penunjuk ke kepala struktur yang ditentukan filter.

Untuk menginisialisasi struktur konteks per file-objek, gunakan makro FsRtlInitPerFileObjectContext .

Untuk mengaitkan struktur konteks per-file-object yang diinisialisasi dengan objek file, gunakan fungsi FsRtlInsertPerFileObjectContext .

Untuk menghapus struktur konteks per file-objek yang terkait dengan objek file, gunakan fungsi 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

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext

Bagikan melalui