Fungsi FsRtlLookupPerFileContext (ntifs.h)
Rutinitas FsRtlLookupPerFileContext mengembalikan penunjuk ke objek FSRTL_PER_FILE_CONTEXT yang terkait dengan file tertentu.
Sintaks
PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
[in] PVOID *PerFileContextPointer,
[in, optional] PVOID OwnerId,
[in, optional] PVOID InstanceId
);
Parameter
[in] PerFileContextPointer
Penunjuk ke penunjuk buram yang digunakan oleh paket pustaka runtime sistem file (FSRTL) untuk melacak konteks file. Untuk mengambil penunjuk ini dari objek file, gunakan makro FsRtlGetPerFileContextPointer .
[in, optional] OwnerId
Penunjuk ke variabel filter yang dialokasikan driver yang secara unik mengidentifikasi pemilik struktur konteks per file. Format variabel ini adalah filter khusus driver. Parameter ini bersifat opsional, tetapi harus non-NULL jika InstanceId bukan NULL.
[in, optional] InstanceId
Penunjuk ke variabel filter yang dialokasikan driver yang dapat digunakan untuk membedakan antara struktur konteks per file yang dibuat oleh driver filter yang sama. Format variabel ini adalah filter khusus driver. Parameter ini bersifat opsional.
Mengembalikan nilai
Penunjuk ke struktur FSRTL_PER_FILE_CONTEXT pertama yang cocok dengan OwnerId dan InstanceId, jika ditentukan, atau NULL jika tidak ada kecocokan yang ditemukan atau sistem file tidak mendukung konteks per file.
Keterangan
Dengan tidak menentukan OwnerID dan InstanceId, driver filter dapat mencari konteks pertama yang terkait dengan file.
Jika sistem file tidak mendukung objek konteks per file, NULL dikembalikan. Gunakan makro FsRtlSupportsPerFileContexts untuk menentukan apakah sistem file mendukung objek konteks per file.
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
Melacak Konteks Per-File dalam Driver Filter Sistem File Warisan