Fungsi FltGetFileContext (fltkernel.h)

Artikel
04/27/2023

Rutinitas FltGetFileContext mengambil konteks yang ditetapkan untuk file oleh instans driver minifilter tertentu.

Sintaks

NTSTATUS FLTAPI FltGetFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file. Parameter ini diperlukan dan tidak boleh NULL.

[out] Context

Penunjuk ke variabel yang dialokasikan penelepon yang menerima alamat konteks. Parameter ini diperlukan dan tidak dapat diatur ke NULL.

Nilai kembali

FltGetFileContext mengembalikan STATUS_SUCCESS ketika berhasil mengembalikan konteks file yang diminta. Jika tidak, ia mengembalikan nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	Tidak ada konteks yang cocok yang ditemukan pada file ini saat ini, jadi FltMgr mengatur Konteks ke NULL_CONTEXT. Ini adalah kode kesalahan.
STATUS_NOT_SUPPORTED	Konteks file tidak didukung untuk file ini. Ini adalah kode kesalahan.

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

Driver minifilter memanggil FltGetFileContext untuk mengambil konteks file yang telah ditetapkan untuk file tertentu.

FltGetFileContext menaikkan jumlah referensi pada konteks yang ditunjuk oleh parameter Konteks . Ketika penunjuk konteks ini tidak lagi diperlukan, pemanggil harus mengurangi jumlah referensinya dengan memanggil FltReleaseContext. Dengan demikian, setiap panggilan yang berhasil ke FltGetFileContext harus dicocokkan dengan panggilan berikutnya ke FltReleaseContext.

Untuk mengatur konteks file, panggil FltSetFileContext.

Untuk mengalokasikan konteks baru, panggil FltAllocateContext.

Untuk menghapus konteks file, panggil FltDeleteFileContext atau FltDeleteContext.

Untuk menentukan apakah konteks file didukung untuk file tertentu, panggil FltSupportsFileContexts atau FltSupportsFileContextsEx.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL