FsRtlEnterFileSystem 函式

發行項
02/07/2024

FsRtlEnterFileSystem 宏會暫時停用 (APC) 一般內核模式異步過程調用的傳遞。仍會傳遞特殊核心模式 APC。

語法

VOID FsRtlEnterFileSystem(
   VOID
);

參數

None

傳回值

此函式不會傳回值。

備註

每個文件系統驅動程式進入點例程都必須立即呼叫 FsRtlEnterFileSystem ，然後才取得執行檔案 I/O 要求所需的資源，然後立即呼叫 FsRtlExitFileSystem 。這可確保例程在執行時無法暫停，因而封鎖其他檔案 I/O 要求。

對 FsRtlEnterFileSystem 的每個成功呼叫都必須與 後續對 FsRtlExitFileSystem 的呼叫相符。

只有在 FsRtlExitFileSystem 或 KeLeaveCriticalRegion 位於相同的分派例程中時，文件系統篩選驅動程式才能在 IoCallDriver 之前呼叫 FsRtlEnterFileSystem 或 KeLeaveCriticalRegion，以停用一般核心 APC 的傳遞。他們不應該在IoCallDriver之前呼叫 FsRtlEnterFileSystem 或KeEnterCriticalRegion，然後在 IRP 完成例程中呼叫 FsRtlExitFileSystem 或 KeLeaveCriticalRegion。驅動程式驗證器具有可協助攔截此條件的規則。

文件系統篩選驅動程式應該先停用一般核心 APC，再取得任何資源。檔案系統篩選驅動程式會使用下列例程取得資源：

作為 FsRtlEnterFileSystem 的替代方案，minifilter 驅動程式可以使用 FltAcquireResourceExclusive、 FltAcquireResourceShared 和 FltReleaseResource 例程，以在取得和釋放資源時正確處理 APC。