FsRtlLookupPerFileContext 函数 (ntifs.h)

项目
02/26/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)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL