FsRtlLookupPerFileObjectContext 函数 (ntifs.h)
对于“旧”文件系统筛选器驱动程序,FsRtlLookupPerFileObjectContext 函数检索以前与文件对象关联的上下文信息。
语法
PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
[in] PFILE_OBJECT FileObject,
[in, optional] PVOID OwnerId,
[in, optional] PVOID InstanceId
);
参数
[in] FileObject
指向要查询上下文信息的文件对象的指针。
[in, optional] OwnerId
指向调用方分配的变量的指针,该变量唯一标识每个文件对象上下文结构的拥有筛选器。 此变量的格式特定于筛选器驱动程序。
[in, optional] InstanceId
指向调用方分配的变量的指针,该变量可用于区分同一筛选器驱动程序创建的每个文件对象上下文结构。 此变量的格式特定于筛选器驱动程序。 此参数是可选的,可以 NULL。
返回值
FsRtlLookupPerFileObjectContext 返回指向找到的每个文件对象上下文的第一个匹配的指针。 如果未找到匹配项,
言论
“旧”文件系统筛选器驱动程序调用 FsRtlLookupPerFileObjectContext 来检索文件对象的每个文件对象上下文结构。 上下文结构包含筛选器驱动程序为文件对象维护的上下文信息。 此上下文结构以前必须通过调用 FsRtlInsertPerFileObjectContext 函数来与文件对象关联。
如果FSRTL_PER_FILEOBJECT_CONTEXT结构嵌入到每个文件对象上下文结构的筛选器中,则 CONTAINING_RECORD 宏可用于获取指向筛选器定义的结构的头的指针。
若要初始化每文件对象上下文结构,请使用 FsRtlInitPerFileObjectContext 宏。
若要将初始化的每个文件对象上下文结构与文件对象相关联,请使用 FsRtlInsertPerFileObjectContext 函数。
若要删除与文件对象关联的每文件对象上下文结构,请使用 FsRtlRemovePerFileObjectContext 函数。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 普遍 |
标头 | ntifs.h (包括 Fltkernel.h、 Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |