IoGetTopLevelIrp 函式 (ntifs.h)
IoGetTopLevelIrp 例程會傳回目前線程 TopLevelIrp 字段的值。
語法
PIRP IoGetTopLevelIrp();
傳回值
IoGetTopLevelIrp 會傳回目前線程 TopLevelIrp 字段的值。
言論
IoGetTopLevelIrp 可以傳回 NULL、任意文件系統特定值(例如目前 IRP 的指標),或下表所列的其中一個旗標。
如果目前的線程在文件系統上方沒有資源,IoGetTopLevelIrp 會傳回 NULL 。
如果文件系統是目前線程的最上層元件,IoGetTopLevelIrp 會傳回目前 IRP 的指標。
如果文件系統以外的元件是目前線程的最上層元件,IoGetTopLevelIrp 會傳回下列其中一個旗標:
旗 | 意義 |
---|---|
FSRTL_FSP_TOP_LEVEL_IRP | 這是遞歸呼叫。 |
FSRTL_CACHE_TOP_LEVEL_IRP | 快取管理員是目前線程的最上層元件。 |
FSRTL_MOD_WRITE_TOP_LEVEL_IRP | 修改的頁面寫入器是目前線程的最上層元件。 |
FSRTL_FAST_IO_TOP_LEVEL_IRP | 快取管理員是目前線程的最上層元件,而目前的線程位於快速 I/O 路徑中。 |
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntifs.h, Wdm.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |