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 擷取其檔案對象的個別檔案對象內容結構。 內容結構包含篩選驅動程式為檔案對象維護的內容資訊。 這個內容結構先前必須呼叫 FsRtlInsertPerFileObjectContext 函式,來與檔案對象相關聯。
如果FSRTL_PER_FILEOBJECT_CONTEXT結構內嵌於每個檔案對象內容結構定義的篩選中,CONTAINING_RECORD 巨集可用來取得篩選定義結構的前端指標。
若要初始化每個 file-object 內容結構,請使用 FsRtlInitPerFileObjectContext 巨集。
若要將初始化的每個 file-object 內容結構與檔案對象產生關聯,請使用 FsRtlInsertPerFileObjectContext 函式。
若要移除與檔案對象相關聯的每個 file-object 內容結構,請使用 FsRtlRemovePerFileObjectContext 函式。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 普遍 |
標頭 | ntifs.h (include Fltkernel.h, Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |