FltSupportsFileContextsEx 函数 (fltkernel.h)

FltSupportsFileContextsEx 例程确定文件系统还是筛选器管理器是否支持给定文件的文件上下文。

语法

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

参数

[in] FileObject

指向表示正在查询其文件上下文支持的文件的文件对象的指针。 此参数是必需的,不能 NULL

[in, optional] Instance

调用方不透明实例指针。 此参数是可选的,可以 NULL。 有关此参数的详细信息,请参阅此页面的“备注”部分。

返回值

如果文件系统或筛选器管理器支持文件上下文,FltSupportsFileContextsEx 返回 TRUE;否则 FALSE

言论

微型筛选器驱动程序可以调用 FltSupportsFileContextsEx 例程,以确定基础文件系统还是筛选器管理器是否支持由 FileObject 表示的文件的文件上下文,而无需分配上下文并尝试设置它。 如果文件不支持上下文类型,则微型筛选器无法将上下文附加到该文件。

对于仅支持每个文件的单个数据流的文件系统(例如 FAT),文件上下文等效于流上下文。 此类文件系统通常支持流上下文,但不支持文件上下文。 相反,筛选器管理器使用文件系统对流上下文的现有支持提供文件上下文支持。 对于附加到这些文件系统的微型筛选器实例,FltSupportsFileContexts 返回 FALSE,而 FltSupportsFileContextsEx 返回 TRUE(当为 实例 参数传递有效的非NULL 值时)。

如果为 实例 参数提供非NULL 值,FltSupportsFileContextsEx 如果文件系统或筛选器管理器支持文件上下文,则返回 TRUE;否则 FALSE

如果 实例 参数 NULL,则仅当文件系统支持文件上下文时,FltSupportsFileContextsEx 才会返回 TRUE。 否则,即使筛选器管理器支持文件上下文,它也会返回 FALSE

请注意,文件系统可能支持某些类型的文件上下文,但不支持其他文件类型。 例如,NTFS 和 FAT 不支持分页文件的文件上下文。

有关上下文的详细信息,请参阅 关于小型筛选器上下文

要求

要求 价值
最低支持的客户端 此例程在 Windows Vista 及更高版本上可用。
目标平台 普遍
标头 fltkernel.h (包括 Fltkernel.h)
FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltGetFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts