FsRtlLookupPerFileContext 函数（ntifs.h）

项目
12/22/2024

FsRtlLookupPerFileContext 例程返回指向与指定文件关联的 FSRTL_PER_FILE_CONTEXT 对象的指针。

语法

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

参数

[in] PerFileContextPointer

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

[in, optional] OwnerId

指向筛选器驱动程序分配的变量的指针，该变量唯一标识每个文件上下文结构的所有者。此变量的格式特定于筛选器驱动程序。此参数是可选的，但如果 InstanceId 为非NULL，则必须为非NULL。

[in, optional] InstanceId

指向筛选器驱动程序分配的变量的指针，该变量可用于区分同一筛选器驱动程序创建的按文件上下文结构。此变量的格式特定于筛选器驱动程序。此参数是可选的。

返回值

指向与 OwnerId 和 InstanceId匹配的第一个FSRTL_PER_FILE_CONTEXT结构的指针，如果未找到匹配项或文件系统不支持每个文件上下文，则 为 NULL。

言论

如果不指定 OwnerID 和 InstanceId，筛选器驱动程序可以搜索与文件关联的第一个上下文。

如果文件系统不支持每个文件上下文对象，则返回 NULL。使用 FsRtlSupportsPerFileContexts 宏来确定文件系统是否支持每文件上下文对象。

要求

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