FsRtlLookupPerFileContext 函式 (ntifs.h)
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
篩選驅動程式配置的變數指標，可用來區別相同篩選驅動程式所建立的每個檔案內容結構。 此變數的格式是篩選驅動程式特定的。 這是選擇性參數。
傳回值
第一個FSRTL_PER_FILE_CONTEXT結構的指標，如果指定，則為符合 OwnerId 和 InstanceId，如果找不到相符專案，或文件系統不支援個別檔案內容，則為 NULL 。
備註
若未指定 OwnerID 和 InstanceId，篩選驅動程式就可以搜尋與檔案相關聯的第一個內容。
如果文件系統不支援個別檔案內容物件，則會傳回 NULL 。 使用 FsRtlSupportsPerFileContexts 宏來判斷文件系統是否支援個別檔案內容物件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 FltKernel.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |