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
呼叫端配置變數的指標，可唯一識別每個檔案對象內容結構的擁有篩選。 此變數的格式為 filter-driver-specific。
[in, optional] InstanceId
呼叫端配置的變數指標，可用來區分相同篩選驅動程式所建立的每個檔案對象內容結構。 此變數的格式為 filter-driver-specific。 這個參數是選擇性的，而且可以是 NULL。
傳回值
FsRtlLookupPerFileObjectContext 會傳回找到的第一個符合每個檔案對象內容的指標。 如果找不到相符專案， FsRtlLookupPerFileObjectContext 會傳回 NULL。
備註
「舊版」文件系統篩選驅動程式會呼叫 FsRtlLookupPerFileObjectContext ，以擷取其檔案物件的個別檔案對象內容結構。 內容結構包含篩選驅動程式為檔案對象維護的內容資訊。 此內容結構先前必須透過呼叫 FsRtlInsertPerFileObjectContext 函式來與檔案對象相關聯。
如果FSRTL_PER_FILEOBJECT_CONTEXT結構內嵌於每個檔案對象內容結構定義的篩選中，則 CONTAINING_RECORD宏可用來 取得篩選定義結構的前端指標。
若要初始化個別檔案對象內容結構，請使用 FsRtlInitPerFileObjectContext 宏。
若要將初始化的每個檔案對象內容結構與檔案對象產生關聯，請使用 FsRtlInsertPerFileObjectContext 函式。
若要移除與檔案對象相關聯的個別檔案對象內容結構，請使用 FsRtlRemovePerFileObjectContext 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Fltkernel.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |