Fungsi FltSupportsFileContextsEx (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltSupportsFileContextsEx menentukan apakah sistem file atau manajer filter mendukung konteks file untuk file tertentu.

Sintaks

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

Parameter

[in] FileObject

Penunjuk ke objek file yang mewakili file yang dukungan konteks filenya sedang dikueri. Parameter ini diperlukan dan tidak boleh NULL.

[in, optional] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini bersifat opsional dan dapat berupa NULL. Untuk informasi selengkapnya tentang parameter ini, lihat bagian Keterangan dari halaman ini.

Nilai kembali

FltSupportsFileContextsEx mengembalikan TRUE jika sistem file atau manajer filter mendukung konteks file untuk file; FALSE jika tidak.

Keterangan

Driver minifilter dapat memanggil rutinitas FltSupportsFileContextsEx untuk menentukan apakah sistem file yang mendasar atau manajer filter mendukung konteks file untuk file yang diwakili oleh FileObject tanpa harus mengalokasikan konteks dan mencoba mengaturnya. Jika jenis konteks tidak didukung pada file, maka minifilter tidak dapat melampirkan konteks ke file tersebut.

Untuk sistem file (seperti FAT) yang hanya mendukung satu aliran data per file, konteks file setara dengan konteks aliran. Sistem file tersebut biasanya mendukung konteks aliran tetapi tidak mendukung konteks file. Sebagai gantinya, manajer filter menyediakan dukungan konteks file, menggunakan dukungan sistem file yang ada untuk konteks aliran. Untuk instans minifilter yang dilampirkan ke sistem file ini, FltSupportsFileContexts mengembalikan FALSE, sementara FltSupportsFileContextsEx mengembalikan TRUE (ketika nilai non-NULL yang valid diteruskan untuk parameter Instans ).

Jika nilai non-NULL disediakan untuk parameter Instans , FltSupportsFileContextsEx mengembalikan TRUE jika sistem file atau manajer filter mendukung konteks file untuk file; FALSE jika tidak.

Jika parameter InstansADALAH NULL, FltSupportsFileContextsEx mengembalikan TRUE hanya jika sistem file mendukung konteks file untuk file. Jika tidak, ia mengembalikan FALSE, bahkan jika manajer filter mendukung konteks file untuk file.

Perhatikan bahwa sistem file mungkin mendukung konteks file untuk beberapa jenis file tetapi tidak untuk yang lain. Misalnya, NTFS dan FAT tidak mendukung konteks file untuk file halaman.

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

Persyaratan

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