共用方式為


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 巨集可用來取得篩選定義結構的前端指標。

若要初始化每個 file-object 內容結構,請使用 FsRtlInitPerFileObjectContext 巨集。

若要將初始化的每個 file-object 內容結構與檔案對象產生關聯,請使用 FsRtlInsertPerFileObjectContext 函式。

若要移除與檔案對象相關聯的每個 file-object 內容結構,請使用 FsRtlRemovePerFileObjectContext 函式。

注意 文件系統迷你篩選驅動程式不得使用 FsRtlXxxPerFileObjectContext 函式。 相反地,小型篩選程式可以使用 FltXxxContext 函式,將內容資訊與檔案對象產生關聯。 如需完整清單,請參閱 FSRTL_PER_FILEOBJECT_CONTEXT 主題。
 

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 普遍
標頭 ntifs.h (include Fltkernel.h, Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext