通过

FsRtlInsertPerFileContext 函数 （ntifs.h）

  • 项目

FsRtlInsertPerFileContext 例程将 FSRTL_PER_FILE_CONTEXT 对象与文件的驱动程序指定的上下文对象相关联。

语法

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

参数

[in] PerFileContextPointer

指向文件系统运行时库 （FSRTL） 包用于跟踪文件上下文的不透明指针的指针。 若要从文件对象中检索此指针，请使用 FsRtlGetPerFileContextPointer 宏。

[in] Ptr

指向特定于驱动程序的上下文结构的指针。

返回值

FsRtlInsertPerFileContext 例程返回STATUS_SUCCESS或相应的错误代码，例如：

返回代码 描述
STATUS_INVALID_DEVICE_REQUEST
 基础文件系统不支持筛选文件上下文。 可以使用 FsRtlSupportsPerFileContexts 宏来检查文件系统是否支持每个文件上下文对象。
STATUS_INSUFFICIENT_RESOURCES
 系统无法分配资源（通常是内存）。

言论

FsRtlGetPerFileContextPointer 宏为打开的文件返回 FileContextSupportPointer。

参数

FileObject

FILE_OBJECT

指向文件对象的指针。

返回值

PVOID

FsRtlGetPerFileContextPointer 宏返回文件系统运行时库 （FSRTL） 包用于跟踪文件上下文的不透明指针。 如果文件系统不支持对文件使用每文件上下文对象，则宏将返回 NULL。

FsRtlGetPerFileContextPointer 宏返回要传递给例程的指针，例如 FsRtlInsertPerFileContext、FsRtlLookupPerFileContext，以及 FsRtlRemovePerFileContext。

有关如何使用和创建上下文对象的详细信息，请参阅旧文件系统筛选器驱动程序中的 跟踪 Per-File 上下文。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 普遍
标头 ntifs.h （包括 FltKernel.h、Ntifs.h）
库 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

另请参阅

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

在旧文件系统筛选器驱动程序 中跟踪 Per-File 上下文