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 上下文。