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或相应的错误代码,例如:
返回代码 | 说明 |
---|---|
|
基础文件系统不支持筛选文件上下文。 可以使用 FsRtlSupportsPerFileContexts 宏检查文件系统是否支持每个文件上下文对象。 |
|
系统无法分配资源 (通常是内存) 。 |
注解
FsRtlGetPerFileContextPointer 宏返回打开文件的 FileContextSupportPointer 。
参数
FileObject
FILE_OBJECT
指向文件对象的指针。
返回值
PVOID
FsRtlGetPerFileContextPointer 宏返回文件系统运行时库 (FSRTL) 包用于跟踪文件上下文的不透明指针。 如果文件系统不支持对文件使用每个文件上下文对象,则宏将返回 NULL 。
FsRtlGetPerFileContextPointer 宏返回要传递给 FsRtlInsertPerFileContext、 FsRtlLookupPerFileContext 和 FsRtlRemovePerFileContext 等例程的指针。
有关如何使用和创建上下文对象的详细信息,请参阅 跟踪旧版文件系统筛选器驱动程序中的 Per-File 上下文。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
目标平台 | 通用 |
标头 | ntifs.h (包括 FltKernel.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=APC_LEVEL |