fltGetFileContext 函数 (fltkernel.h)

项目
02/26/2024

FltGetFileContext 例程检索由给定的微筛选器驱动程序实例为文件设置的上下文。

语法

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

参数

[in] Instance

调用方不透明的实例指针。此参数是必需的，不能为 NULL。

[in] FileObject

文件的文件对象指针。此参数是必需的，不能为 NULL。

[out] Context

指向调用方分配的变量的指针，该变量接收上下文的地址。此参数是必需的，不能设置为 NULL。

返回值

FltGetFileContext 在成功返回请求的文件上下文时返回STATUS_SUCCESS。否则，它将返回相应的 NTSTATUS 值，如以下值之一：

返回代码	说明
STATUS_NOT_FOUND	此时在此文件上找不到匹配的上下文，因此 FltMgr 将 Context 设置为 NULL_CONTEXT。这是错误代码。
STATUS_NOT_SUPPORTED	此文件不支持文件上下文。这是错误代码。

注解

有关上下文的详细信息，请参阅关于微筛选器上下文。

微筛选器驱动程序调用 FltGetFileContext 来检索它为给定文件设置的文件上下文。

FltGetFileContext 递增 Context 参数指向的上下文的引用计数。当不再需要此上下文指针时，调用方必须通过调用 FltReleaseContext 来递减其引用计数。因此，每次成功调用 FltGetFileContext 都必须与后续调用 FltReleaseContext 相匹配。

若要设置文件上下文，请调用 FltSetFileContext。

若要分配新上下文，请调用 FltAllocateContext。

若要删除文件上下文，请调用 FltDeleteFileContext 或 FltDeleteContext。

若要确定给定文件是否支持文件上下文，请调用 FltSupportsFileContexts 或 FltSupportsFileContextsEx。

要求

要求	值
最低受支持的客户端	Windows Vista
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL